> ## Documentation Index > Fetch the complete documentation index at: https://deepline.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Context.dev: Contextdev Post News Search > Search company news. Context.dev Contextdev Post News Search reference includes SDK V2 and CLI requests, input constraints, response fields, and Deepline cost. Search company news. Tool ID: `contextdev_post_news_search` ## Run this action Use the TypeScript SDK for a single call. Put `ctx.tools.execute(...)` inside a Play when the call should be durable, scheduled, or run across a CSV. ```ts theme={null} import { Deepline } from 'deepline'; const deepline = await Deepline.connect(); const result = await deepline.tools.execute( 'contextdev_post_news_search', { "searchBy": { "type": "entity", "entity": { "type": "name", "name": "Example" } } }, ); console.log(result.toolResponse.raw); ``` ### CLI ```bash theme={null} deepline tools execute contextdev_post_news_search --input '{ "searchBy": { "type": "entity", "entity": { "type": "name", "name": "Example" } } }' --json ``` ## Example response The SDK exposes this shape at `result.toolResponse.raw`. Values below are representative. ```json theme={null} { "data": { "data": [ { "id": "id_123", "story_id": "story_123", "url": "https://example.com/resource", "title": "VP of Engineering", "description": "Example description", "language": "en", "authors": [ "example" ], "image_url": "https://example.com", "published_at": "2026-01-15T12:00:00Z", "type": "editorial", "source": { "name": "Example", "domain": "example.com", "direct": true }, "match": { "level": "primary", "confidence": 0.95 } } ], "has_more": true, "next_cursor": "cursor_123", "meta": { "count": 123 } } } ``` Use `deepline tools get contextdev_post_news_search --json` for the latest machine-readable contract. ## Input reference Searches live and historical company news for one company, identified in searchBy by name, domain, ticker (optionally disambiguated by exchange), or ISIN. Results can be filtered by publisher domain, publisher country, article language, article type, and published-at date, and include stable story IDs, source metadata, verified entity relevance, and cursor pagination. | Name | Type | Required | Default | Details | | ------------------ | --------- | -------- | ----------------------------- | ------------------------------------------------------------------------------------------------ | | `payload.searchBy` | `object` | Yes | — | What to search for. | | `payload.filterBy` | `object` | No | `{}` | Optional result filters. | | `payload.sortBy` | `object` | No | `{"type":"string"}` | Result ordering. Defaults to newest. | | `payload.limit` | `integer` | No | `10` | Maximum results to return. Defaults to 10. Minimum: 1. Maximum: 100. | | `payload.cursor` | `string` | No | — | Opaque next\_cursor from the previous response, or null for the first page. Maximum length: 300. | | `payload.tags` | `array` | No | — | Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters. Maximum items: 20. |
Show raw input schema ### Input JSON Schema ```json theme={null} { "type": "object", "description": "Searches live and historical company news for one company, identified in searchBy by name, domain, ticker (optionally disambiguated by exchange), or ISIN. Results can be filtered by publisher domain, publisher country, article language, article type, and published-at date, and include stable story IDs, source metadata, verified entity relevance, and cursor pagination.", "properties": { "searchBy": { "type": "object", "description": "What to search for.", "properties": { "type": { "type": "string", "description": "How to search. Only entity search is supported.", "enum": [ "entity" ] }, "entity": { "description": "The company to search news for, identified by name, domain, ticker, or ISIN.", "anyOf": [ { "type": "object", "description": "Identify the company by name.", "properties": { "type": { "type": "string", "enum": [ "name" ] }, "name": { "type": "string", "description": "Company name.", "minLength": 2, "maxLength": 200 } }, "required": [ "type", "name" ], "additionalProperties": false }, { "type": "object", "description": "Identify the company by website domain.", "properties": { "type": { "type": "string", "enum": [ "domain" ] }, "domain": { "type": "string", "description": "Company website domain, such as apple.com.", "minLength": 1, "maxLength": 253 } }, "required": [ "type", "domain" ], "additionalProperties": false }, { "type": "object", "description": "Identify the company by stock ticker, optionally scoped to an exchange.", "properties": { "type": { "type": "string", "enum": [ "ticker" ] }, "ticker": { "type": "string", "description": "Public-company ticker.", "minLength": 1, "maxLength": 20, "pattern": "^[A-Za-z0-9.-]+$" }, "exchange": { "type": "string", "description": "Stock exchange the ticker trades on, used to disambiguate tickers listed on multiple exchanges.", "enum": [ "AMEX", "AMS", "AQS", "ASX", "ATH", "BER", "BME", "BRU", "BSE", "BUD", "BUE", "BVC", "CBOE", "CNQ", "CPH", "DFM", "DOH", "DUB", "DUS", "DXE", "EGX", "FSX", "HAM", "HEL", "HKSE", "HOSE", "ICE", "IOB", "IST", "JKT", "JNB", "JPX", "KLS", "KOE", "KSC", "KUW", "LIS", "LSE", "MCX", "MEX", "MIL", "MUN", "NASDAQ", "NEO", "NSE", "NYSE", "NZE", "OSL", "OTC", "PAR", "PNK", "PRA", "RIS", "SAO", "SAU", "SES", "SET", "SGO", "SHH", "SHZ", "SIX", "STO", "STU", "TAI", "TAL", "TLV", "TSX", "TSXV", "TWO", "VIE", "WSE", "XETRA" ] } }, "required": [ "type", "ticker" ], "additionalProperties": false }, { "type": "object", "description": "Identify the company by International Securities Identification Number.", "properties": { "type": { "type": "string", "enum": [ "isin" ] }, "isin": { "type": "string", "description": "International Securities Identification Number.", "pattern": "^[A-Za-z]{2}[A-Za-z0-9]{9}[0-9]$" } }, "required": [ "type", "isin" ], "additionalProperties": false } ] } }, "required": [ "type", "entity" ], "additionalProperties": false }, "filterBy": { "type": "object", "description": "Optional result filters.", "default": {}, "properties": { "sourceDomain": { "type": "array", "description": "Publisher domains to include. Up to 3.", "minItems": 1, "maxItems": 3, "items": { "type": "string", "minLength": 1, "maxLength": 253 } }, "sourceCountry": { "type": "array", "description": "Publisher countries to include, as lowercase ISO 3166-1 alpha-2 codes. Up to 3.", "minItems": 1, "maxItems": 3, "items": { "type": "string", "enum": [ "ae", "ar", "au", "ca", "cg", "ch", "cl", "de", "fi", "fr", "gb", "hk", "il", "in", "jp", "kr", "mx", "ng", "nl", "qa", "sa", "se", "sg", "us", "za" ] } }, "articleLanguage": { "type": "array", "description": "Article languages to include. Up to 3.", "minItems": 1, "maxItems": 3, "items": { "type": "string", "enum": [ "ar", "de", "en", "es", "fr", "hi", "it", "ja", "ko", "nl", "pt", "ru", "zh" ] } }, "articleType": { "type": "array", "description": "Article types to include. Up to 3.", "minItems": 1, "maxItems": 3, "items": { "type": "string", "enum": [ "editorial", "press_release", "regulatory_filing", "advisory" ] } }, "date": { "type": "object", "description": "Published-at window in epoch milliseconds.", "properties": { "from": { "type": "integer", "description": "Inclusive start of the published-at window, in epoch milliseconds." }, "to": { "type": "integer", "description": "Inclusive end of the published-at window, in epoch milliseconds." } }, "additionalProperties": false } }, "additionalProperties": false }, "sortBy": { "type": "object", "description": "Result ordering. Defaults to newest.", "default": { "type": "string" }, "properties": { "type": { "type": "string", "description": "Result ordering.", "enum": [ "relevance", "newest" ] } }, "required": [ "type" ], "additionalProperties": false }, "limit": { "type": "integer", "description": "Maximum results to return. Defaults to 10.", "default": 10, "minimum": 1, "maximum": 100 }, "cursor": { "type": [ "string", "null" ], "description": "Opaque next_cursor from the previous response, or null for the first page.", "maxLength": 300 }, "tags": { "type": "array", "description": "Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.", "maxItems": 20, "items": { "type": "string", "minLength": 1, "maxLength": 50 } } }, "required": [ "searchBy" ], "additionalProperties": false } ```
## Output reference | Name | Type | Required | Default | Details | | ------------------------------------- | --------------------------------------------------------------------- | -------- | ------- | ----------------------------------------------------------------------- | | `result.data` | `object` | Yes | — | — | | `result.data.data` | `array` | Yes | — | — | | `result.data.data[].id` | `string` | Yes | — | — | | `result.data.data[].story_id` | `string` | Yes | — | — | | `result.data.data[].url` | `string` | Yes | — | Format: `uri`. | | `result.data.data[].title` | `string` | Yes | — | — | | `result.data.data[].description` | `string \| null` | Yes | — | — | | `result.data.data[].language` | `string \| null` | Yes | — | — | | `result.data.data[].authors` | `array` | Yes | — | — | | `result.data.data[].image_url` | `string \| null` | Yes | — | — | | `result.data.data[].published_at` | `string \| null` | Yes | — | Format: `date-time`. | | `result.data.data[].type` | `"editorial" \| "press_release" \| "regulatory_filing" \| "advisory"` | Yes | — | Allowed: `editorial`, `press_release`, `regulatory_filing`, `advisory`. | | `result.data.data[].source` | `object` | Yes | — | — | | `result.data.data[].source.name` | `string` | Yes | — | — | | `result.data.data[].source.domain` | `string` | Yes | — | — | | `result.data.data[].source.direct` | `boolean` | Yes | — | — | | `result.data.data[].match` | `object` | Yes | — | — | | `result.data.data[].match.level` | `"primary" \| "secondary"` | Yes | — | Allowed: `primary`, `secondary`. | | `result.data.data[].match.confidence` | `number \| null` | Yes | — | Minimum: 0. Maximum: 1. | | `result.data.has_more` | `boolean` | Yes | — | — | | `result.data.next_cursor` | `string \| null` | Yes | — | — | | `result.data.meta` | `object` | Yes | — | — | | `result.data.meta.count` | `integer` | Yes | — | Minimum: 0. | | `result.data.key_metadata` | `object` | No | — | — | | `result.meta` | `object` | No | — | — |
Show raw output schema ### Output JSON Schema ```json theme={null} { "type": "object", "properties": { "data": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "story_id": { "type": "string" }, "url": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "language": { "type": [ "string", "null" ] }, "authors": { "type": "array", "items": { "type": "string" } }, "image_url": { "type": [ "string", "null" ] }, "published_at": { "type": [ "string", "null" ], "format": "date-time" }, "type": { "type": "string", "enum": [ "editorial", "press_release", "regulatory_filing", "advisory" ] }, "source": { "type": "object", "properties": { "name": { "type": "string" }, "domain": { "type": "string" }, "direct": { "type": "boolean" } }, "required": [ "name", "domain", "direct" ], "additionalProperties": false }, "match": { "type": "object", "properties": { "level": { "type": "string", "enum": [ "primary", "secondary" ] }, "confidence": { "type": [ "number", "null" ], "minimum": 0, "maximum": 1 } }, "required": [ "level", "confidence" ], "additionalProperties": false } }, "required": [ "id", "story_id", "url", "title", "description", "language", "authors", "image_url", "published_at", "type", "source", "match" ], "additionalProperties": false } }, "has_more": { "type": "boolean" }, "next_cursor": { "type": [ "string", "null" ] }, "meta": { "type": "object", "properties": { "count": { "type": "integer", "minimum": 0 } }, "required": [ "count" ], "additionalProperties": false }, "key_metadata": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } }, "required": [ "data", "has_more", "next_cursor", "meta" ], "additionalProperties": false }, "meta": { "type": "object", "additionalProperties": true } }, "required": [ "data" ], "additionalProperties": false } ```
## Deepline cost * Pricing model: `fixed` (per call). * Estimated Deepline credits: `0` per pricing unit. * Provider-native pricing may still exist outside Deepline credit billing. ## Related documentation * [Context.dev provider guide](/docs/providers/contextdev/guide) * [SDK V2 quickstart](/docs/sdk-v2/quickstart) * [SDK reference](/docs/sdk-v2/sdk-reference) * [Run tools across a CSV](/docs/sdk-v2/batch-csv)