---
title: "Entity correlation analysis with time-series"
description: "Analyze correlation between multiple entities over time with sentiment tracking and source filtering"
source: https://apitube.io/cookbook/entity-correlation-analysis-with-time-series
---

#### Input parameters

| Parameter        | Description                                    | Type    | Default | Required |
|:-----------------|:-----------------------------------------------|:--------|:--------|:---------|
| entity.id        | Multiple entity IDs (comma-separated).         | string  |         | Yes      |
| published_at.start | Start date for time range.                     | string  |         | Yes      |
| published_at.end | End date for time range.                       | string  |         | Yes      |
| sort.by          | Sort by sentiment score.                       | string  |         | Yes      |
| sort.order       | Descending order.                               | string  |         | Yes      |
| is_duplicate     | Exclude duplicates.                            | integer | 0       | Yes      |
| api_key          | Your API key.                                  | string  |         | Yes      |
| per_page         | Maximum number of articles to retrieve.       | integer | 50      | No       |

#### Workflow examples

##### Request for entity correlation analysis:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268,1282301&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"
```

##### Request for entity mention tracking over time:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268&published_at.start=2022-01-01&published_at.end=2023-12-31&per_page=100&sort.by=published_at&sort.order=asc&api_key=YOUR_API_KEY"
```

##### Request for entity co-occurrence network analysis:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268&organization.name=Tesla&published_at.start=2023-01-01&published_at.end=2023-12-31&sort.by=published_at&api_key=YOUR_API_KEY"
```

##### Request for entity impact on market sentiment:

```shell
curl -X GET "https://api.apitube.io/v1/news/everything?entity.id=1278268,1282301&category.id=medtop:04000000&sentiment.overall.score.min=0.7&published_at.start=2023-01-01&sort.by=sentiment.overall.score&sort.order=desc&api_key=YOUR_API_KEY"
```

---

#### Related Examples

- [Cross-reference person with organizations](/cookbook/cross-reference-person-with-organizations-and-locations)
- [Brand reputation analysis](/cookbook/brand-reputation-analysis-across-markets)
- [Competitive intelligence analysis](/cookbook/competitive-intelligence-analysis-with-sentiment-tracking)
- [Filter articles mentioning persons](/cookbook/filter-articles-mentioning-persons)
- [Sort by engagement score](/cookbook/sort-articles-by-engagement-score)