Sign in

v17

latestOpenAPI 3.0.1raw.githubusercontent.com2026-05-072674388.0 KB
v1

News (Vector)

Perform a natural language search over news articles from the past 6 months using semantic relevance. The result includes a list of articles most closely matched to your query intent.

post/v1/vector/news/all

Request body

promptstring required

Natural language query to search the news articles database

pubDateFromstring date-time nullable

'pubDateFrom' filter, will search articles published after the specified date, the date could be passed as ISO or 'yyyy-mm-dd'. Date time in ISO format, ie. 2024-01-01T00:00:00 - Default: Only articles with a pubDate within the last 30 days of the request

pubDateTostring date-time nullable

'pubDateTo' filter, will search articles published before the specified date, the date could be passed as ISO or 'yyyy-mm-dd'. Date time in ISO format, ie. 2024-01-01T00:00:00

showReprintsboolean nullable

Whether to return reprints in the response or not. Reprints are usually wired articles from sources like AP or Reuters that are reprinted in multiple sources at the same time. By default, this parameter is 'true'.

sizeinteger nullable

The number of items per page.

pageinteger nullable

The page number to retrieve.

Example request

{
  "prompt": "Enter your prompt",
  "filter": {
    "articleId": [
      ""
    ],
    "clusterId": [
      ""
    ],
    "source": [
      ""
    ],
    "excludeSource": [
      ""
    ],
    "sourceGroup": [
      ""
    ],
    "language": [
      ""
    ],
    "excludeLanguage": [
      ""
    ],
    "label": [
      ""
    ],
    "excludeLabel": [
      ""
    ],
    "taxonomy": [
      ""
    ],
    "category": [
      ""
    ],
    "topic": [
      ""
    ],
    "excludeTopic": [
      ""
    ],
    "country": [
      ""
    ],
    "excludeCountry": [
      ""
    ],
    "locationsCountry": [
      ""
    ],
    "excludeLocationsCountry": [
      ""
    ],
    "state": [
      ""
    ],
    "excludeState": [
      ""
    ],
    "county": [
      ""
    ],
    "excludeCounty": [
      ""
    ],
    "city": [
      ""
    ],
    "excludeCity": [
      ""
    ],
    "sourceCountry": [
      ""
    ],
    "sourceState": [
      ""
    ],
    "sourceCounty": [
      ""
    ],
    "sourceCity": [
      ""
    ],
    "companyId": [
      ""
    ],
    "excludeCompanyId": [
      ""
    ],
    "companyDomain": [
      ""
    ],
    "excludeCompanyDomain": [
      ""
    ],
    "companySymbol": [
      ""
    ],
    "excludeCompanySymbol": [
      ""
    ],
    "companyName": [
      ""
    ],
    "personWikidataId": [
      ""
    ],
    "excludePersonWikidataId": [
      ""
    ],
    "personName": [
      ""
    ],
    "excludePersonName": [
      ""
    ],
    "AND": [
      {}
    ],
    "OR": [
      {}
    ],
    "NOT": [
      {}
    ]
  },
  "pubDateFrom": "2024-01-01T00:00:00Z",
  "pubDateTo": "2024-12-31T23:59:59Z"
}

Response

200 - Success

statusinteger required

Example response

{
  "status": 200,
  "results": [
    {
      "score": 0.6707077,
      "data": {
        "articleId": "be5db1909bb94e0e953c0537d80d1728",
        "clusterId": "85246d2dfb784a66a70946c382000615",
        "url": "https://woai.iheart.com/content/2025-07-30-tesla-samsung-select-texas-town-as-new-hub-for-ai-chip-manufacturing/",
        "authorsByline": "",
        "matchedAuthors": [],
        "imageUrl": "https://i.iheart.com/v3/re/assets.getty/64d0f5da53634efa19c55bbb?ops=gravity(%22north%22),fit(1200,675),quality(65)",
        "pubDate": "2025-07-31T08:30:00Z",
        "addDate": "2025-07-31T08:37:17.593902Z",
        "language": "en",
        "source": {
          "domain": "woai.iheart.com",
          "location": {
            "country": "us",
            "state": "AZ",
            "county": "Pima County",
            "city": "Tucson",
            "coordinates": {
              "lat": 32.1988848,
              "lon": -110.8218543
            }
          }
        },
        "country": "us",
        "reprint": false,
        "reprintGroupId": "ab5901166eff4e8781ad9bf362818ed6",
        "title": "Tesla, Samsung Select Texas Town As New Hub For AI Chip Manufacturing",
        "translatedTitle": "",
        "summary": "Texas has seen significant growth in recent years, largely due to companies like Tesla and Samsung moving operations to the state. This comes as Tesla signed a $16.5 billion deal with Samsung to manufacture new AI6 chips in Taylor, Texas. The chips are considered the brains behind Tesla's next-generation autonomous vehicles. This investment in Texas is seen as a significant investment that will keep a significant amount of money and jobs in the state, particularly as AI continues to grow. The deal signals that Texas is now the leading for technology, outpacing Silicon Valley. This is also a sign that the state is becoming more relevant in the rapidly changing world of technological advancement.",
        "translatedSummary": "",
        "labels": [],
        "topics": [
          {
            "name": "AI"
          }
        ],
        "taxonomies": [
          {
            "name": "/News/Technology News"
          },
          {
            "name": "/News/Business News/Company News"
          },
          {
            "name": "/Autos & Vehicles/Motor Vehicles (By Brand)/Tesla Motors"
          }
        ],
        "categories": [
          {
            "name": "Tech"
          },
          {
            "name": "Auto"
          }
        ],
        "entities": [
          {
            "data": "Tesla",
            "type": "ORG",
            "mentions": 4
          },
          {
            "data": "Samsung",
            "type": "ORG",
            "mentions": 2
          },
          {
            "data": "KTRH High Tech",
            "type": "ORG",
            "mentions": 1
          },
          {
            "data": "Texas",
            "type": "GPE",
            "mentions": 11
          },
          {
            "data": "the Lone Star State",
            "type": "GPE",
            "mentions": 2
          },
          {
            "data": "Taylor",
            "type": "GPE",
            "mentions": 1
          },
          {
            "data": "South Korea",
            "type": "GPE",
            "mentions": 1
          },
          {
            "data": "Taiwan",
            "type": "GPE",
            "mentions": 1
          },
          {
            "data": "AI6",
            "type": "PRODUCT",
            "mentions": 1
          },
          {
            "data": "Texans",
            "type": "NORP",
            "mentions": 1
          },
          {
            "data": "American",
            "type": "NORP",
            "mentions": 1
          },
          {
            "data": "Michael Garfield",
            "type": "PERSON",
            "mentions": 3
          },
          {
            "data": "Trump",
            "type": "PERSON",
            "mentions": 1
          },
          {
            "data": "Silicon Valley",
            "type": "LOC",
            "mentions": 1
          }
        ],
        "companies": [
          {
            "id": "16c0e6ea111945fb9c5af03fc7ce6d82",
            "name": "Samsung C&T Corporation",
            "domains": [
              "samsungcnt.com"
            ],
            "symbols": [
              "028260.KS",
              "02826K.KS"
            ]
          },
          {
            "id": "165c2312f79e4d3d982a75eec3054904",
            "name": "Samsung India Software Operations",
            "domains": [
              "samsungindiasoft.com"
            ],
            "symbols": []
          },
          {
            "id": "eeee660a046242b8bf99f45fdc95cc32",
            "name": "Tesla, Inc.",
            "domains": [
              "tesla.com"
            ],
            "symbols": [
              "TSLA",
              "TL0.DE"
            ]
          }
        ],
        "people": [],
        "locations": [
          {
            "country": "us",
            "state": "TX",
            "county": "Williamson County"
          }
        ],
        "places": []
      }
    }
  ]
}