# Intellizence Company News Signals API > **Ready to get started?** [**Request your API key**](https://intellizence.com/api-trial/) and start building. > > **Questions?** [**Schedule a call**](https://intellizence.com/schedule-a-demo/) or email us at . **Security Notice:** Please keep the API Key secure. Do not share your API key in publicly accessible areas such as GitHub, client-side code, and so forth. ## Search for news signals by Company Domain(s), Intellizence Trigger Code(s) & News Published Date range > Returns curated news articles for the given company domain(s), trigger code(s), and published date range. A news record may include clustered or related articles under \`similarNews\`.\ > \ > Users can search data using the following parameters: \`companyDomains\`, \`triggerCodes\`, \`startDate\`, \`endDate\`, and \`limit\`\ > \ > Users can limit the number of records returned using the \`limit\` parameter. The default limit is \`100\`. All parameters are optional.\ > \ > The API key must be passed in the HTTP header as \`x-api-key\`. ```json {"openapi":"3.0.3","info":{"title":"Intellizence Company News Signals API","version":"1.0"},"servers":[{"url":"https://connect.intellizence.com","description":"Intellizence API"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","name":"x-api-key","in":"header"}},"schemas":{"NewsSearchRequest":{"type":"object","properties":{"companyDomains":{"type":"array","description":"Website domain of the Companies for which news signal are required. Multiple domains can be passed as an array.","items":{"type":"string"}},"triggerCodes":{"type":"array","description":"Intellizence Trigger Codes used to filter relevant news signals. Multiple Trigger Code(s) can be passed as an array. For a categorized reference of all codes, [click here](https://docs.intellizence.com/company-news-signal-api/trigger-codes-reference)","items":{"type":"string","enum":["KW_518","KW_519","KW_520","KW_534","KW_535","KW_666","KW_502","KW_536","KW_591","KW_741","KW_514","KW_708","KW_516","KW_527","KW_529","KW_640","KW_713","KW_510","KW_583","KW_688","KW_521","KW_566","KW_642","KW_537","KW_801","KW_512","KW_513","KW_528","KW_687","KW_584","KW_586","KW_641","KW_532","KW_610","KW_143","KW_533","KW_709","KW_556","KW_571","KW_647","KW_14","KW_526","KW_711","KW_522","KW_523","KW_585","KW_613","KW_699","KW_589","KW_654","KW_665","KW_678","KW_530","KW_601","KW_677","KW_531","KW_616","KW_524","KW_673","KW_700","KW_737"]}},"startDate":{"type":"string","description":"News published start date. Enter the date in YYYY-MM-DD format.","format":"date"},"endDate":{"type":"string","description":"News published end date. Enter the date in YYYY-MM-DD format.","format":"date"},"limit":{"type":"integer","description":"Maximum number of records to return","default":100}}},"NewsSearchResponse":{"required":["code","count","news"],"type":"object","properties":{"code":{"type":"integer"},"count":{"type":"integer"},"news":{"type":"array","items":{"$ref":"#/components/schemas/NewsItem"}},"openingBalance":{"type":"integer","description":"Returned only for the 'Pay-Per-Use' billing type."},"closingBalance":{"type":"integer","description":"Returned only for the 'Pay-Per-Use' billing type."},"creditsConsumed":{"type":"integer","description":"Returned only for the 'Pay-Per-Use' billing type."}}},"NewsItem":{"type":"object","properties":{"publisher":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"desc":{"type":"string"},"hash":{"type":"string"},"triggerNames":{"type":"array","items":{"type":"string"}},"companyNames":{"type":"array","items":{"type":"string"}},"triggerCodes":{"type":"array","items":{"type":"string"}},"companyDomains":{"type":"array","items":{"type":"string"}},"publishDate":{"type":"string","format":"date"},"similarNews":{"type":"array","items":{"$ref":"#/components/schemas/SimilarNewsItem"}}}},"SimilarNewsItem":{"type":"object","properties":{"hash":{"type":"string"},"title":{"type":"string"},"desc":{"type":"string"},"publisher":{"type":"string"},"url":{"type":"string","format":"uri"},"publishDate":{"type":"string","format":"date-time"}}}}},"paths":{"/api/news":{"post":{"summary":"Search for news signals by Company Domain(s), Intellizence Trigger Code(s) & News Published Date range","description":"Returns curated news articles for the given company domain(s), trigger code(s), and published date range. A news record may include clustered or related articles under `similarNews`.\n\nUsers can search data using the following parameters: `companyDomains`, `triggerCodes`, `startDate`, `endDate`, and `limit`\n\nUsers can limit the number of records returned using the `limit` parameter. The default limit is `100`. All parameters are optional.\n\nThe API key must be passed in the HTTP header as `x-api-key`.","operationId":"serachCompanyNewsSignals","parameters":[{"name":"x-api-key","in":"header","description":"Intellizence API key","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful response.\n\nNote: Credit fields (openingBalance, closingBalance, creditsConsumed) are returned only for Pay-Per-Use billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewsSearchResponse"}}}},"400":{"description":"400 - Bad Request\n\nBad request, possibly missing required parameters, invalid data, invalid or missing API key.\n\n- 701 - Invalid Start Date format (YYYY-MM-DD required)\n- 702 - Invalid End Date format (YYYY-MM-DD required)\n- 706 - Requested resource/data product is not included in the current subscription plan\n- 709 - No companies configured for this account\n- 710 - No triggers configured for this account"},"402":{"description":"402 - Payment Required\n- 704 - Payment is pending\n- 712 - Insufficient credits for this request"},"403":{"description":"403 - Forbidden\n- 703 - Plan or resource not subscribed\n- 707 - Subscription has expired\n- 708 - Start date is outside your subscription’s allowed date range"},"500":{"description":"500 - Internal Server Error\n- 715 - A technical error occurred\n- 799 - A technical error occurred"}}}}}} ``` ## The NewsSearchRequest object ```json {"openapi":"3.0.3","info":{"title":"Intellizence Company News Signals API","version":"1.0"},"components":{"schemas":{"NewsSearchRequest":{"type":"object","properties":{"companyDomains":{"type":"array","description":"Website domain of the Companies for which news signal are required. Multiple domains can be passed as an array.","items":{"type":"string"}},"triggerCodes":{"type":"array","description":"Intellizence Trigger Codes used to filter relevant news signals. Multiple Trigger Code(s) can be passed as an array. For a categorized reference of all codes, [click here](https://docs.intellizence.com/company-news-signal-api/trigger-codes-reference)","items":{"type":"string","enum":["KW_518","KW_519","KW_520","KW_534","KW_535","KW_666","KW_502","KW_536","KW_591","KW_741","KW_514","KW_708","KW_516","KW_527","KW_529","KW_640","KW_713","KW_510","KW_583","KW_688","KW_521","KW_566","KW_642","KW_537","KW_801","KW_512","KW_513","KW_528","KW_687","KW_584","KW_586","KW_641","KW_532","KW_610","KW_143","KW_533","KW_709","KW_556","KW_571","KW_647","KW_14","KW_526","KW_711","KW_522","KW_523","KW_585","KW_613","KW_699","KW_589","KW_654","KW_665","KW_678","KW_530","KW_601","KW_677","KW_531","KW_616","KW_524","KW_673","KW_700","KW_737"]}},"startDate":{"type":"string","description":"News published start date. Enter the date in YYYY-MM-DD format.","format":"date"},"endDate":{"type":"string","description":"News published end date. Enter the date in YYYY-MM-DD format.","format":"date"},"limit":{"type":"integer","description":"Maximum number of records to return","default":100}}}}}} ``` ## The NewsSearchResponse object ```json {"openapi":"3.0.3","info":{"title":"Intellizence Company News Signals API","version":"1.0"},"components":{"schemas":{"NewsSearchResponse":{"required":["code","count","news"],"type":"object","properties":{"code":{"type":"integer"},"count":{"type":"integer"},"news":{"type":"array","items":{"$ref":"#/components/schemas/NewsItem"}},"openingBalance":{"type":"integer","description":"Returned only for the 'Pay-Per-Use' billing type."},"closingBalance":{"type":"integer","description":"Returned only for the 'Pay-Per-Use' billing type."},"creditsConsumed":{"type":"integer","description":"Returned only for the 'Pay-Per-Use' billing type."}}},"NewsItem":{"type":"object","properties":{"publisher":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"desc":{"type":"string"},"hash":{"type":"string"},"triggerNames":{"type":"array","items":{"type":"string"}},"companyNames":{"type":"array","items":{"type":"string"}},"triggerCodes":{"type":"array","items":{"type":"string"}},"companyDomains":{"type":"array","items":{"type":"string"}},"publishDate":{"type":"string","format":"date"},"similarNews":{"type":"array","items":{"$ref":"#/components/schemas/SimilarNewsItem"}}}},"SimilarNewsItem":{"type":"object","properties":{"hash":{"type":"string"},"title":{"type":"string"},"desc":{"type":"string"},"publisher":{"type":"string"},"url":{"type":"string","format":"uri"},"publishDate":{"type":"string","format":"date-time"}}}}}} ``` ## The NewsItem object ```json {"openapi":"3.0.3","info":{"title":"Intellizence Company News Signals API","version":"1.0"},"components":{"schemas":{"NewsItem":{"type":"object","properties":{"publisher":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"desc":{"type":"string"},"hash":{"type":"string"},"triggerNames":{"type":"array","items":{"type":"string"}},"companyNames":{"type":"array","items":{"type":"string"}},"triggerCodes":{"type":"array","items":{"type":"string"}},"companyDomains":{"type":"array","items":{"type":"string"}},"publishDate":{"type":"string","format":"date"},"similarNews":{"type":"array","items":{"$ref":"#/components/schemas/SimilarNewsItem"}}}},"SimilarNewsItem":{"type":"object","properties":{"hash":{"type":"string"},"title":{"type":"string"},"desc":{"type":"string"},"publisher":{"type":"string"},"url":{"type":"string","format":"uri"},"publishDate":{"type":"string","format":"date-time"}}}}}} ``` ## The SimilarNewsItem object ```json {"openapi":"3.0.3","info":{"title":"Intellizence Company News Signals API","version":"1.0"},"components":{"schemas":{"SimilarNewsItem":{"type":"object","properties":{"hash":{"type":"string"},"title":{"type":"string"},"desc":{"type":"string"},"publisher":{"type":"string"},"url":{"type":"string","format":"uri"},"publishDate":{"type":"string","format":"date-time"}}}}}} ``` ## The ErrorResponse object ```json {"openapi":"3.0.3","info":{"title":"Intellizence Company News Signals API","version":"1.0"},"components":{"schemas":{"ErrorResponse":{"required":["code","message"],"type":"object","properties":{"code":{"type":"integer","description":"Business error code (701–799)."},"message":{"type":"string"}}}}}} ```