Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.
openapi: 3.2.0
info:
title: NewsCatcher CatchAll Meta API
version: 1.6.1
description: CatchAll is a web search API that generates unique datasets that don't exist anywhere else on the web.
contact:
name: NewsCatcher
url: https://newscatcherapi.com
email: support@newscatcherapi.com
servers:
- url: https://catchall.newscatcherapi.com
description: Production server
security:
- ApiKeyAuth: []
tags:
- name: Meta
description: Operations to check API health and version.
paths:
/health:
get:
tags:
- Meta
summary: Check health
description: Check API availability.
operationId: healthCheck
security: []
responses:
'200':
$ref: '#/components/responses/HealthCheckResponse'
/version:
get:
tags:
- Meta
summary: Get version
description: Returns current API version.
operationId: getVersion
security: []
responses:
'200':
$ref: '#/components/responses/VersionResponse'
/catchAll/user/limits:
post:
tags:
- Meta
summary: Get plan limits
description: Returns plan features and current usage for the authenticated organization.
operationId: getPlanLimits
responses:
'200':
$ref: '#/components/responses/GetPlanLimitsResponse'
'403':
$ref: '#/components/responses/ForbiddenError'
components:
responses:
VersionResponse:
description: API version
content:
application/json:
schema:
type: object
properties:
version:
type: string
example: 1.3.1
ForbiddenError:
description: Invalid or missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
HealthCheckResponse:
description: API is healthy
content:
application/json:
schema:
type: object
properties:
healthy:
type: boolean
example: true
GetPlanLimitsResponse:
description: Plan limits retrieved successfully
content:
application/json:
schema:
$ref: '#/components/schemas/GetPlanLimitsResponseDto'
example:
features:
- name: Jobs Concurrency
code: Jobs_Concurrency
value_type: integer
value: 20
current_usage: 1
- name: Max Results
code: Job_Max_Results
value_type: integer
value: 100000
current_usage: 0
- name: Monthly Granted Credits
code: monthly_free_credits
value_type: integer
value: 200000
current_usage: 0
schemas:
Error:
type: object
properties:
detail:
type: string
description: Error message.
example: Invalid API key
PlanFeature:
type: object
required:
- name
- code
properties:
name:
type: string
description: Human-readable feature name.
example: Jobs Concurrency
code:
type: string
description: Machine-readable feature identifier.
example: Jobs_Concurrency
value_type:
type: string
description: Data type of the feature value.
example: integer
value:
description: Feature limit. Type depends on `value_type`.
example: 20
current_usage:
type: number
description: Current usage count for this feature.
example: 1
GetPlanLimitsResponseDto:
type: object
required:
- features
properties:
features:
type: array
items:
$ref: '#/components/schemas/PlanFeature'
description: Plan features with current usage.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: API key for authentication.
externalDocs:
description: Find out more about NewsCatcher CatchAll API
url: https://www.newscatcherapi.com/docs/web-search-api/get-started/introduction
x-provenance:
method: harvested
publisher: Newscatcher
source: https://catchall.newscatcherapi.com/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)