The New York Times Company · Example Payload

Semantic Concept Example

NewsMediaPublishingNewspapersArticlesBooksMoviesSportsGamesCookingReviewsSearchSemanticTaggingControlled VocabularyGeographicArchive

Semantic Concept Example is an example object payload from The New York Times Company, with 4 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

statuscopyrightnum_resultsresults

Example Payload

{
  "status": "OK",
  "copyright": "Copyright (c) 2026 The New York Times Company. All Rights Reserved.",
  "num_results": 1,
  "results": [
    {
      "concept_id": 41960,
      "concept_name": "Obama, Barack",
      "concept_status": "Active",
      "concept_type": "nytd_per",
      "vernacular": "Obama, Barack",
      "is_times_tag": 1,
      "concept_created": "2003-01-01 00:00:00",
      "concept_updated": "2024-01-15 12:00:00",
      "search_api_query": "https://api.nytimes.com/svc/search/v2/articlesearch.json?fq=persons%3A(%22Obama%2C+Barack%22)",
      "article_list": {
        "results": [
          {
            "title": "Barack Obama on the State of Democracy",
            "url": "https://www.nytimes.com/2024/09/12/us/politics/obama-democracy.html",
            "byline": "By Peter Baker",
            "date": "2024-09-12T00:00:00Z"
          }
        ],
        "total": 8421
      }
    }
  ]
}

Work with this as data

Every example 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 examples

4 MCP tools reach this

find_examplesBrowse and filter every example in the catalog.
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 example

curl "https://apis.io/api/v1/examples/semantic-concept-example"

All examples

curl "https://apis.io/api/v1/examples?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.