How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Newscatcher Datasets API

Operations to create and manage datasets of entities.A dataset is a named collection of entities — think of it as a watchlist orportfolio. Connect a dataset to a job via `connected_dataset_ids` to activateCompany Watchlist. Datasets can be reused across multiple jobs and monitors.

Newscatcher Datasets API is one of 16 APIs that Newscatcher publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Datasets. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 11 operations across 7 paths, and defines 26 schemas. It is described by OpenAPI 3.2.0, at version 1.6.1.

Requests are made against a single base URL, https://catchall.newscatcherapi.com.

11 operations 7 paths 26 schemas 2 DELETE3 GET1 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.6.1
Base URL
https://v3-api.newscatcherapi.com/api
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Newscatcher Datasets API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — API key for authentication.

Paths & Operations 11

Across 7 paths, the API surfaces 11 operations — 2 DELETE, 3 GET, 1 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Datasets 11

Operations to create and manage datasets of entities. A dataset is a named collection of entities — think of it as a watchlist or portfolio. Connect a dataset to a job via connect…

GET
/catchAll/datasets
List datasets
listDatasets 8 params → 200403
POST
/catchAll/datasets
Create dataset
createDataset body → 200400403422
POST
/catchAll/datasets/upload
Create dataset from CSV
createDatasetFromCsv body → 200403422
GET
/catchAll/datasets/{dataset_id}
Get dataset
getDataset 1 param → 200403404
PATCH
/catchAll/datasets/{dataset_id}
Update dataset
updateDataset 1 param body → 200403404422
DELETE
/catchAll/datasets/{dataset_id}
Delete dataset
deleteDataset 1 param → 204403404
POST
/catchAll/datasets/{dataset_id}/entities
Add entities to dataset
addEntitiesToDataset 1 param body → 200403404422
DELETE
/catchAll/datasets/{dataset_id}/entities
Remove entities from dataset
removeEntitiesFromDataset 1 param body → 200403404422
POST
/catchAll/datasets/{dataset_id}/entities/list
List entities in dataset
listEntitiesInDataset 1 param body → 200403404422
GET
/catchAll/datasets/{dataset_id}/status
Get dataset status history
getDatasetStatusHistory 1 param → 200403404
POST
/catchAll/datasets/{dataset_id}/upload
Add companies to dataset via CSV
uploadCSVToDataset 1 param body → 200403404422

Schemas 26

The contract defines 26 schemas that model the data the API accepts and returns. The most detailed are DatasetResponse (9 properties), ListDatasetEntitiesRequest (7 properties), EntitySummary (6 properties), ValidationReport (4 properties). Each schema is shown below with its type and property counts.

DatasetStatusEntry
object
A single status change event in a dataset's history.
3 properties 1 required
UploadCsvToDatasetResponse
object
3 properties 3 required
DatasetStatus
string
Processing status of a dataset. - pending: Dataset created, entities queued for enrichment. - enriching: Entities are being enriched. - ready: All entities enr…
ValidationErrorDetail
object
3 properties
CreateDatasetRequest
object
3 properties 1 required
CompanyAttributes
object
Identifying attributes for a company entity. All fields are optional but improve matching quality.
4 properties
ValidationReport
object
Summary of CSV processing results.
4 properties 4 required
EntitySummary
object
Abbreviated entity object returned when listing entities within a dataset. Uses a flat attributes key rather than the nested additionalattributes.companyattrib…
6 properties 4 required
DatasetEntityListResponse
object
4 properties 4 required
DatasetEntityIdsRequest
object
1 property 1 required
EntitySortBy
string
Fields available for sorting entity list results.
DatasetStatusHistoryResponse
object
2 properties 2 required
DatasetSortBy
string
Fields available for sorting dataset list results.
OwnershipFilter
string
Controls which resources are returned based on ownership. - all: Returns resources owned by the user and resources shared with them (default, backward compatib…
SkippedRow
object
Details about a CSV row that was skipped during processing.
2 properties 2 required
DatasetResponse
object
9 properties 3 required
DatasetListResponse
object
4 properties 4 required
ListDatasetEntitiesRequest
object
7 properties
EntityStatus
string
Processing status of an entity. - pending: Entity has been created and is queued for enrichment. - enriching: Enrichment is in progress. - ready: Enrichment co…
SortOrder
string
Sort direction for list results. - asc: ascending (oldest or smallest first) - desc: descending (newest or largest first)
ValidationErrorResponse
object
1 property
Error
object
1 property
ManageEntitiesResponse
object
2 properties 2 required
CreateDatasetCsvResponse
object
4 properties 4 required
EntityType
string
The type of entity. - company: A company or organization (default). - person: An individual person.
UpdateDatasetRequest
object
Updates dataset name or description. At least one field should be provided.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

newscatcher-datasets-api-openapi.yml Raw ↑

Other APIs Newscatcher publishes across the network.

Newscatcher AggregationCount API
Newscatcher Authors API
Newscatcher BreakingNews API
Newscatcher Entities API
Newscatcher Jobs API
Newscatcher LatestHeadlines API
Newscatcher Meta API
Newscatcher Monitors API
Newscatcher Projects API
Newscatcher Search API
Newscatcher SearchBy API
Newscatcher SearchByLink API
Where this information came from

This is an independent, third-party profile of Newscatcher Datasets API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.