info@ismena.com
Ismena websiteIsmena websiteIsmena websiteIsmena website
  • Home
  • About us
  • Technologies
    • Cloud Services
      • Google Cloud Platform
        • Networking
        • Compute
        • Storage
        • SAP on GCP
        • Google Maps
        • Data Center Modernization
    • Infrastructure
      • iSolution Services
      • Unified Communication
      • Network Security
      • Access Security & Control
      • Computing Platforms
      • Structured Cabling Infrastructure
      • Datacenter Infrastructure
      • Networking Infrastructure
      • Retail Analytics
      • Cloud Infrastructure
    • Integration
      • Apigee
      • IBM
      • Custom Connectors
      • UnifAI
    • Security
      • Security Consulting Services
      • Security Solutions
    • Data & AI
      • BigQuery, Looker
      • Gemini
    • Collaboration Tools
      • Google Workspace For Enterprise
    • ERP-CRM
      • Odoo
      • Salesforce
      • SAP on GCP
    • DevOps
      • GCP
      • SonarSource
    • Managed Service Provider
      • Managed Service Provider
    • App Development
      • App Development
    • Open Banking
      • Open banking
    • Chrome Devices
  • Unplugged Podcast
  • Blog
    • Success Stories
    • News
    • Articles
  • Careers
  • Contact Us

Technologies

Integration

Custom Connectors

Explore All Connectors

NYTimes Connector

NYTimes Connector

Connector Details

Type

Virtual machines, Single VM , BYOL

Runs on

Google Compute Engine

Last Update

24 October, 2024

Category

Overview

Documentation

Pricing

Support

Overview

The NY Times Connector provides seamless integration with The New York Times, enabling easy access to article search, archive data, and top stories. Acting as a secure proxy, it simplifies communication between client applications and NYTimes services by managing authentication, headers, and query parameters automatically.

This connector streamlines data retrieval and reduces integration complexity, supporting actions such as searching articles, retrieving historical archives by month and year, and fetching top stories by section. By consolidating these capabilities into a single interface, the NYTimes Connector makes it easy for developers and organizations to incorporate rich NYTimes content into their systems.

Integration Overview

This document provides a detailed guide for each integration point, its purpose, configuration, and workflow support using the NYTimes Connector.

Supported Integration Action Points:

  • /svc/search/v2/articlesearch.json: Searches for articles based on query parameters.
  • /svc/archive/v1/{year}/{month}.json: Retrieves archive data for a specific month and year.
  • /svc/topstories/v2/{section}.json: Fetches top stories for a specified section.

Detailed Integration Documentation

Article Search

Action /svc/search/v2/articlesearch.json
Purpose Searches for articles based on query parameters provided by the client.
Parameters
  • Required: api-key (provided via environment variable or query parameter).
  • Optional: Various search parameters (e.g., q, fq, begin_date) as per NYTimes API documentation.
Configuration Ensure the connector is configured with environment variables CONNECTOR_ENV_NYTIMES_BASE_URL and CONNECTOR_ENV_NYTIMES_API_KEY.
Output
  • Successful: Returns a JSON object with search results.
  • Failure: Returns a 401 status code if no API key is provided, or a 500 status code if the API request fails.
Workflow Example
  • Enter your API key in the environment variable CONNECTOR_ENV_NYTIMES_API_KEY or as a query parameter.
  • Input search parameters (e.g., q=technology) in the request.
  • Click to execute the /svc/search/v2/articlesearch.json action.
  • Review the response to see the list of articles.
  • Use the data for content aggregation or analysis.

Archive Retrieval

Action /svc/archive/v1/{year}/{month}.json
Purpose Retrieves archive data for a specific month and year from the NYTimes API.
Parameters
  • Required: year (integer, e.g., 2025), month (integer, e.g., 9).
  • Optional: api-key (provided via environment variable or query parameter), additional archive parameters.
Configuration Ensure the connector is configured with environment variables CONNECTOR_ENV_NYTIMES_BASE_URL and CONNECTOR_ENV_NYTIMES_API_KEY.
Output
  • Successful: Returns a JSON object with archive data.
  • Failure: Returns a 401 status code if no API key is provided, or a 500 status code if the API request fails.
Workflow Example
  • Enter your API key in the environment variable CONNECTOR_ENV_NYTIMES_API_KEY or as a query parameter.
  • Input the year (e.g., 2025) and month (e.g., 9) in the URL path.
  • Click to execute the /svc/archive/v1/{year}/{month}.json action.
  • Review the response to see the archive data.
  • Use the data for historical analysis or reporting.

Top Stories Retrieval

Action /svc/topstories/v2/{section}.json
Purpose Fetches top stories for a specified section from the NYTimes API.
Parameters
  • Required: section (string, e.g., home).
  • Optional: api-key (provided via environment variable or query parameter).
Configuration Ensure the connector is configured with environment variables CONNECTOR_ENV_NYTIMES_BASE_URL and CONNECTOR_ENV_NYTIMES_API_KEY.
Output
  • Successful: Returns a JSON object with top stories.
  • Failure: Returns a 401 status code if no API key is provided, or a 500 status code if the API request fails.
Workflow Example
  • Enter your API key in the environment variable CONNECTOR_ENV_NYTIMES_API_KEY or as a query parameter.
  • Input the section (e.g., home) in the URL path.
  • Click to execute the /svc/topstories/v2/{section}.json action.
  • Review the response to see the top stories.
  • Use the data for news aggregation or display.

Workflow Creation with the Connector

Example Workflow: News Data Retrieval and Analysis

Article Search
  • Enter your API key.
  • Input search term (e.g., climate).
  • Click to execute /svc/search/v2/articlesearch.json.
  • Review articles for relevant content.
Archive Retrieval
  • Enter your API key.
  • Input year (e.g., 2025) and month (e.g., 9).
  • Click to execute /svc/archive/v1/{year}/{month}.json.
  • Analyze historical data.
Top Stories Retrieval
  • Enter your API key.
  • Input section (e.g., home).
  • Click to execute /svc/topstories/v2/{section}.json.
  • Display top stories on a dashboard.

Pricing

Request a Quote

Support

For Technical support please contact us on

custom-connectors-support@isolutions.sa

iSolution logo - white - transparent 250 px

iSolution logo - white - transparent 250 px

A tech solution company dedicated to providing innovation thus empowering businesses to thrive in the digital age.

  • Home
  • About us
  • Blog
  • Careers
  • Success Stories
  • News
  • Articles
  • Contact Us
  • Terms and conditions
  • Privacy Policy
© Copyright 2024 iSolution | All Rights Reserved
  • Home
  • About us
  • Technologies
    • Cloud Services
      • Google Cloud Platform
        • Networking
        • Compute
        • Storage
        • SAP on GCP
        • Google Maps
        • Data Center Modernization
    • Infrastructure
      • iSolution Services
      • Unified Communication
      • Network Security
      • Access Security & Control
      • Computing Platforms
      • Structured Cabling Infrastructure
      • Datacenter Infrastructure
      • Networking Infrastructure
      • Retail Analytics
      • Cloud Infrastructure
    • Integration
      • Apigee
      • IBM
      • Custom Connectors
      • UnifAI
    • Security
      • Security Consulting Services
      • Security Solutions
    • Data & AI
      • BigQuery, Looker
      • Gemini
    • Collaboration Tools
      • Google Workspace For Enterprise
    • ERP-CRM
      • Odoo
      • Salesforce
      • SAP on GCP
    • DevOps
      • GCP
      • SonarSource
    • Managed Service Provider
      • Managed Service Provider
    • App Development
      • App Development
    • Open Banking
      • Open banking
    • Chrome Devices
  • Unplugged Podcast
  • Blog
    • Success Stories
    • News
    • Articles
  • Careers
  • Contact Us
Ismena website

Register To Palo Alto & iSolution Event

Register to IBM x iSolution Event

Register to Gemini in Action Workshop

[forminator_form id=”14485″]

Registration To Amman Unplugged Event

[forminator_form id=”14419″]

Register to Gemini in Action Workshop

[forminator_form id=”14298″]

Tech and Culture Riyadh

[forminator_form id=”13094″]