GET /company/offices

Company Offices

Get headquarters location and office locations for any company, including opening dates and press references for new offices.

Crunchbase Data API

Retrieve office location data for a company — headquarters, additional offices, opening dates, descriptions of new office announcements, and press references documenting each location. Use this endpoint to track geographic expansion, identify companies entering new markets, or build location-based prospect lists.

HTTP Request

1

GET /company/offices

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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

{
  "status": true,
  "request_id": "c2f478c6-35d4-7c3e-6582-42ec2ce0",
  "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.",
    "headquarters": [
      {
        "name": "Menlo Park",
        "slug": "menlo-park-california",
        "uuid": "1f8abfef-5379-b26b-7020-05a09908492f",
        "location_type": "city"
      },
      {
        "name": "California",
        "slug": "california-united-states",
        "uuid": "eb879a83-c91a-121e-0bb8-829782dbcf04",
        "location_type": "region"
      }
    ],
    "offices": [
      {
        "uuid": "bc3caefe-d59e-41fe-b53e-c32e501ff4b5",
        "name": "Meta Temple Data Center",
        "location": [],
        "opened_on": "2027-01-01",
        "opening_description": "Meta Platforms Inc. is constructing a new data center campus in Temple, Texas, expected to be completed by 2027.",
        "opening_press_reference": {
          "title": "Construction of Meta's data center campus north of Austin to continue through 2026",
          "url": "https://www.bizjournals.com/austin/news/2025/03/26/meta-temple-data-center-construction-update-austin.html",
          "posted_on": "2025-03-26",
          "publisher": "Seattle TechFlash",
          "thumbnail_url": null
        }
      },
      {
        "uuid": "5034fe04-262f-4bc3-99a4-d0873bb05a3d",
        "name": null,
        "location": [],
        "opened_on": "2026-03-18",
        "opening_description": "Meta Platforms signed a 10-year lease with Vornado Realty Trust for a five-story townhouse at 697 Fifth Avenue in Midtown Manhattan.",
        "opening_press_reference": {
          "title": "Meta leases from Vornado again, this time for retail space",
          "url": "https://therealdeal.com/new-york/2026/03/18/meta-leases-from-vornado-again-this-time-for-retail-space/",
          "posted_on": "2026-03-18",
          "publisher": "The Real Deal",
          "thumbnail_url": null
        }
      }
      // ... more items
    ]
  },
  "_meta": {
    "is_cached": false,
    "cached_at": 1778020004.7748556,
    "cached_at_iso": "2026-05-05T22:26:44Z"
  },
  "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.headquartersarrayHeadquarters location hierarchy
data.headquarters[].namestringLocation name (city, region, or country)
data.headquarters[].slugstringLocation slug
data.headquarters[].uuidstringLocation UUID
data.headquarters[].location_typestringType: city, region, country
data.officesarrayOffice locations
data.offices[].uuidstringOffice UUID
data.offices[].namestring/nullOffice name (may be null)
data.offices[].locationarrayLocation details (may be empty)
data.offices[].opened_onstringDate office was opened or announced (YYYY-MM-DD)
data.offices[].opening_descriptionstringDescription of the office opening or expansion
data.offices[].opening_press_referenceobjectPress article about the office opening
data.offices[].opening_press_reference.titlestringArticle title
data.offices[].opening_press_reference.urlstringArticle URL
data.offices[].opening_press_reference.posted_onstringPublication date (YYYY-MM-DD)
data.offices[].opening_press_reference.publisherstringPublisher name
data.offices[].opening_press_reference.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
27
28
29

import requests

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

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']} — Office Locations")

# Headquarters
hq_parts = [loc["name"] for loc in data["headquarters"]]
print(f"HQ: {', '.join(hq_parts)}")

# Other offices
print(f"\nOffices ({len(data['offices'])} total):")
for office in data["offices"]:
    name = office["name"] or "Unnamed office"
    print(f"  - {name} (opened: {office['opened_on']})")
    print(f"    {office['opening_description'][:80]}...")

 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

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

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} — Office Locations`);

// Headquarters
const hqParts = data.headquarters.map(loc => loc.name);
console.log(`HQ: ${hqParts.join(", ")}`);

// Other offices
console.log(`\nOffices (${data.offices.length} total):`);
data.offices.forEach(office => {
  const name = office.name || "Unnamed office";
  console.log(`  - ${name} (opened: ${office.opened_on})`);
  console.log(`    ${office.opening_description.slice(0, 80)}...`);
});

1
2
3
4
5

curl -G "https://crunchbase-extractor-full-api3.p.rapidapi.com/company/offices" \
  --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 Timeline
Next Company Intelligence
Start building today

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

Get Your API Key on RapidAPI