Webz.io News API
Pricing
from $2.00 / 1,000 news searches
Describe the news you need in plain language. Webz.io finds relevant articles worldwide, ready for your product, research, or AI application, with precise filtering options.
You can access the Webz.io News API programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "WOKTF40ztfGybfmUe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webzio~news-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webzio-news-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/webzio~news-search/runs": { "post": { "operationId": "runs-sync-webzio-news-search", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/webzio~news-search/run-sync": { "post": { "operationId": "run-sync-webzio-news-search", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "query" ], "properties": { "query": { "title": "Query", "type": "string", "description": "Natural-language topic or question. Maximum 750 characters and 100 words." }, "k": { "title": "Number of articles", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many articles to return.", "default": 10 }, "days": { "title": "Published within days", "minimum": 0, "maximum": 30, "type": "integer", "description": "Only articles published in the last N days, counted in UTC. Coverage is 30 days. Leave empty to use the API default. Do not set this together with Published from." }, "score_gte": { "title": "Minimum match score", "minimum": 0, "maximum": 10, "type": "number", "description": "Minimum semantic match score, 0 to 10. The API default is 4. Use 0 to disable the floor." }, "score_lte": { "title": "Maximum match score", "minimum": 0, "maximum": 10, "type": "number", "description": "Maximum semantic match score, 0 to 10." }, "allow_multiple_chunks_per_article": { "title": "Multiple excerpts per article", "type": "boolean", "description": "Return more than one matching passage from the same article." }, "language": { "title": "Language", "type": "array", "description": "Article languages, for example english.", "items": { "type": "string" } }, "country": { "title": "Country", "type": "array", "description": "Source countries as ISO-2 codes, for example US or GB.", "items": { "type": "string" } }, "category": { "title": "Category", "type": "array", "description": "Article categories, for example Politics.", "items": { "type": "string" } }, "sentiment": { "title": "Sentiment", "type": "array", "description": "positive, negative, or neutral.", "items": { "type": "string" } }, "published_from": { "title": "Published from", "type": "string", "description": "Earliest publish date, YYYY-MM-DD. Do not set this together with Published within days." }, "published_to": { "title": "Published to", "type": "string", "description": "Latest publish date, YYYY-MM-DD." }, "domain": { "title": "Domain", "type": "array", "description": "Only these source domains, for example cnn.com.", "items": { "type": "string" } }, "exclude_domain": { "title": "Exclude domain", "type": "array", "description": "Skip these source domains. A domain cannot be in both Domain and Exclude domain.", "items": { "type": "string" } }, "topic": { "title": "Topic", "type": "array", "description": "Topic tags, finer than category.", "items": { "type": "string" } }, "person": { "title": "Person", "type": "array", "description": "People mentioned in the article.", "items": { "type": "string" } }, "organization": { "title": "Organization", "type": "array", "description": "Organizations mentioned in the article.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "array", "description": "Locations mentioned in the article.", "items": { "type": "string" } }, "ticker": { "title": "Ticker", "type": "array", "description": "Stock tickers of mentioned organizations, for example NVDA.", "items": { "type": "string" } }, "political_bias": { "title": "Political bias", "type": "array", "description": "Source bias: left, center, or right.", "items": { "type": "string" } }, "trust_category": { "title": "Trust category", "type": "string", "description": "trusted_news, fake_news, or satirical_news." }, "source_type": { "title": "Source type", "type": "string", "description": "local_news, newsroom, or gov_news." }, "domain_rank_gte": { "title": "Minimum domain rank", "minimum": 1, "type": "integer", "description": "Minimum Tranco domain rank. 1 is the most popular." }, "domain_rank_lte": { "title": "Maximum domain rank", "minimum": 1, "type": "integer", "description": "Maximum Tranco domain rank." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Webz.io News API from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: