> ## Documentation Index > Fetch the complete documentation index at: https://docs.api.tamtam.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get news for a company > Return news items published for the company since the given timestamp (default: last 30 days, max lookback: 90 days). The company must be in Key Accounts — see [Add companies to Key Accounts](/api-reference/key-accounts/add-companies-to-key-accounts) to add one. ## OpenAPI ````yaml /reference/openapi.yaml get /v2/companies/{linkedin_id}/news openapi: 3.1.0 info: title: Tamtam Public API version: 2.0.0 servers: - url: https://api.tamtam.ai/api security: [] paths: /v2/companies/{linkedin_id}/news: get: tags: - Companies summary: Get news for a company description: >- Return news items published for the company since the given timestamp (default: last 30 days, max lookback: 90 days). The company must be in Key Accounts — see [Add companies to Key Accounts](/api-reference/key-accounts/add-companies-to-key-accounts) to add one. operationId: get-company-news parameters: - description: >- LinkedIn numeric company ID. If you only have a name, domain or LinkedIn URL, resolve it first via [Search for a company](/api-reference/companies/search-for-a-company). in: path name: linkedin_id required: true schema: description: >- LinkedIn numeric company ID. If you only have a name, domain or LinkedIn URL, resolve it first via [Search for a company](/api-reference/companies/search-for-a-company). examples: - '104924588' type: string - description: >- Return news published since this RFC3339 timestamp. Defaults to 30 days ago. Max lookback is 90 days. explode: false in: query name: since schema: description: >- Return news published since this RFC3339 timestamp. Defaults to 30 days ago. Max lookback is 90 days. examples: - '2025-05-01T00:00:00Z' format: date-time type: string - description: Maximum number of news items to return. explode: false in: query name: limit schema: default: 100 description: Maximum number of news items to return. examples: - 100 format: int32 maximum: 200 minimum: 1 type: integer - description: >- If true, only return articles flagged as relevant to your account's sales opportunities. explode: false in: query name: relevant_only schema: default: false description: >- If true, only return articles flagged as relevant to your account's sales opportunities. type: boolean responses: '200': content: application/json: schema: $ref: '#/components/schemas/GetCompanyNewsResponseDto' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/ErrorModel' description: Error security: - apikeyAuth: [] - bearerAuth: [] components: schemas: GetCompanyNewsResponseDto: additionalProperties: false properties: news: description: News items for the company, ordered by publication date descending items: $ref: '#/components/schemas/CompanyNewsItemDto' type: - array - 'null' required: - news type: object ErrorModel: additionalProperties: false properties: detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object CompanyNewsItemDto: additionalProperties: false properties: key_points: description: Key points summarising the article. examples: - - >- Tamtam raised €3 million in Seed funding led by Varsity, with Kima Ventures and business angels participating. - >- The AI-driven platform analyzes public data to help sales teams identify prospects and improve sales performance. - >- Clients have seen a 57% increase in sales conversion rates and a 47% boost in annual contract value. - >- Funds will support growth in France, new AI features, and expansion into Europe and the US. - >- Tamtam aims to streamline complex sales by automating data analysis and providing actionable insights. items: type: string type: - array - 'null' link: description: URL of the article examples: - >- https://www.startuphub.ai/tamtam-secures-e3-million-seed-funding-to-revolutionize-complex-sales-with-ai/ type: string published_at: description: Publication date (day precision, UTC midnight) examples: - '2025-05-30T00:00:00Z' format: date-time type: string relevance: $ref: '#/components/schemas/CompanyNewsRelevanceDto' description: >- Per-account relevance assessment. Absent when not yet computed for this article. title: description: Article title examples: - >- Tamtam Secures €3 Million Seed Funding to Revolutionize Complex Sales with AI type: string required: - title - link - published_at - key_points type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object CompanyNewsRelevanceDto: additionalProperties: false properties: actionable_insights: description: >- Concrete actionable insights derived from this article — e.g. new contacts, potential client needs, timing for outreach. examples: - - >- Leverage the Seed funding news to approach potential investors or partners interested in AI sales tech. - >- Target mid-market and enterprise sales teams in France, Europe, and the US as TAMTAM expands there. - >- Use the reported sales performance improvements (57% conversion increase, 47% contract value boost) as strong proof points in sales pitches. - >- Focus outreach on companies facing complex B2B sales challenges who can benefit from AI-driven sales intelligence and automation. items: type: string type: - array - 'null' is_relevant: description: >- Whether this article is relevant to your account's sales opportunities. examples: - true type: boolean rationale: description: Why this article is relevant to your account's sales opportunities. examples: - >- The article highlights TAMTAM’s AI-driven platform improving sales conversion and contract value, directly aligning with the company’s value proposition and growth plans. type: string required: - is_relevant type: object securitySchemes: apikeyAuth: description: Account API key passed in the Authorization header in: header name: Authorization type: apiKey bearerAuth: description: Bearer JWT obtained via the OAuth 2.1 authorization flow scheme: bearer type: http ````