GET /company/timeline

Company Timeline

Get timeline entry count and recent press references for any company, tracking news coverage and media mentions over time.

Crunchbase Data API

Retrieve the timeline summary for a company — the total number of timeline entries and recent press references. Use this endpoint to monitor media coverage, track press mentions over time, identify trending companies by press volume, or build news feeds for your target accounts.

HTTP Request

1

GET /company/timeline

Parameters

ParameterTypeRequiredDefaultDescription
idstringYes—Company slug (e.g., meta, stripe, openai) or UUID
freshbooleanNofalseSkip cache and fetch fresh data (billed as non-cached request)
max_age_secondsintegerNo—Return fresh fetch if cached record is older than this many seconds
fieldsstringNo—Comma-separated allow-list of top-level fields to include

Response

Example Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

{
  "status": true,
  "request_id": "7315b810-54eb-ef87-a8d2-07e14b5f",
  "data": {
    "uuid": "df662812-7f97-0b43-9d3e-12f64f504fbb",
    "slug": "meta",
    "name": "Meta",
    "image": "https://images.crunchbase.com/image/upload/whm4ed1rrc8skbdi3biv",
    "short_description": "Meta is a social technology company that enables people to connect, find communities, and grow businesses.",
    "num_timeline_entries": 75219,
    "recent_press": [
      {
        "title": "Meta Platforms Reportedly Sued Over Alleged Illegal Use of Copyrighted Content to Train AI",
        "url": "https://www.marketscreener.com/news/meta-platforms-reportedly-sued-over-alleged-illegal-use-of-copyrighted-content-to-train-ai-ce7f58dcdf8bf52c",
        "posted_on": "2026-05-05",
        "publisher": "MarketScreener",
        "author": "MT Newswires",
        "thumbnail_url": null
      },
      {
        "title": "Major publishers sue Meta for copyright infringement over AI training",
        "url": "https://www.investing.com/news/stock-market-news/major-publishers-sue-meta-for-copyright-infringement-over-ai-training-4659515",
        "posted_on": "2026-05-05",
        "publisher": "Investing.com",
        "author": null,
        "thumbnail_url": null
      }
      // ... more items
    ]
  },
  "_meta": {
    "is_cached": false,
    "cached_at": 1778020005.9871337,
    "cached_at_iso": "2026-05-05T22:26:45Z"
  },
  "request_params": {
    "id": "meta",
    "fresh": "false"
  }
}

Response Fields

FieldTypeDescription
statusbooleanWhether the request succeeded
request_idstringUnique identifier for this request
data.uuidstringCrunchbase UUID
data.slugstringCrunchbase URL slug
data.namestringCompany display name
data.imagestringCompany logo URL
data.short_descriptionstringOne-line company summary
data.num_timeline_entriesintegerTotal number of timeline entries for this company
data.recent_pressarrayRecent press references
data.recent_press[].titlestringArticle title
data.recent_press[].urlstringArticle URL
data.recent_press[].posted_onstringPublication date (YYYY-MM-DD)
data.recent_press[].publisherstringPublisher name
data.recent_press[].authorstring/nullArticle author
data.recent_press[].thumbnail_urlstring/nullThumbnail image URL
_meta.is_cachedbooleanWhether response came from cache
_meta.cached_atnumberUnix timestamp of cache time
_meta.cached_at_isostringISO timestamp of cache time
request_paramsobjectEcho of request parameters

Code Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

import requests

url = "https://crunchbase-extractor-full-api3.p.rapidapi.com/company/timeline"

params = {
    "id": "meta",
    "fresh": False
}

headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "crunchbase-extractor-full-api3.p.rapidapi.com"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()["data"]

print(f"{data['name']} — Timeline")
print(f"Total timeline entries: {data['num_timeline_entries']:,}")

print("\nRecent press:")
for press in data["recent_press"]:
    author = f" by {press['author']}" if press["author"] else ""
    print(f"  [{press['posted_on']}] {press['title']}")
    print(f"    {press['publisher']}{author}")
    print(f"    {press['url']}")

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

const url = "https://crunchbase-extractor-full-api3.p.rapidapi.com/company/timeline";

const params = new URLSearchParams({
  id: "meta",
  fresh: "false"
});

const response = await fetch(`${url}?${params}`, {
  headers: {
    "X-RapidAPI-Key": "YOUR_API_KEY",
    "X-RapidAPI-Host": "crunchbase-extractor-full-api3.p.rapidapi.com"
  }
});

const { data } = await response.json();

console.log(`${data.name} — Timeline`);
console.log(`Total timeline entries: ${data.num_timeline_entries.toLocaleString()}`);

console.log("\nRecent press:");
data.recent_press.forEach(press => {
  const author = press.author ? ` by ${press.author}` : "";
  console.log(`  [${press.posted_on}] ${press.title}`);
  console.log(`    ${press.publisher}${author}`);
  console.log(`    ${press.url}`);
});

1
2
3
4
5

curl -G "https://crunchbase-extractor-full-api3.p.rapidapi.com/company/timeline" \
  --data-urlencode "id=meta" \
  --data-urlencode "fresh=false" \
  -H "X-RapidAPI-Key: YOUR_API_KEY" \
  -H "X-RapidAPI-Host: crunchbase-extractor-full-api3.p.rapidapi.com"
Previous Company Risk
Next Company Offices
Start building today

Get your API key and make your first request in under a minute.

Get Your API Key on RapidAPI