Skip to content
Salvo

Examples use fictional data. Every company, person, address and count in them is invented, and their domains use the reserved .example TLD.

GTM data

Segments

The taxonomy the whole graph is filed under — plus the geography and industry roll-ups you need to size a market before you touch a row.

4 endpoints

GET/v1/segments

List segments

Every segment with the number of companies filed under it — 0 until the data catalog is loaded. Pass a query to filter by label or keyword.

API key or sessionFree

Query parameters

FieldTypeDescription
qstringCase-insensitive match against label, description and keywords.
curl "https://beamro.com/api/v1/segments?q=event" \
  -H "x-api-key: $SALVO_API_KEY"
200 response
{
  "rows": [
    {
      "id": "seg_event_management",
      "slug": "event-management",
      "label": "Event management",
      "emoji": "🎪",
      "description": "Studios and agencies that plan, design and run events end to end.",
      "company_count": 1284,
      "parent_slug": null,
      "keywords": [
        "event planning",
        "event design",
        "production"
      ]
    },
    {
      "id": "seg_wedding_planners",
      "slug": "wedding-planners",
      "label": "Wedding planners",
      "emoji": "💐",
      "description": "Independent planners and studios producing weddings.",
      "company_count": 376,
      "parent_slug": "event-management",
      "keywords": [
        "wedding",
        "bridal",
        "planner"
      ]
    }
  ]
}
GET/v1/segments/{slug}

Retrieve a segment

One segment with its children, its nearest neighbours and a sample of companies inside it. Until the data catalog is loaded the sample is empty and catalog_empty is true.

API key or sessionFree — the sample rows are not charged

Path parameters

FieldTypeDescription
slugreqstringSegment slug, e.g. event-management.
curl "https://beamro.com/api/v1/segments/event-management" \
  -H "x-api-key: $SALVO_API_KEY"
200 response
{
  "segment": {
    "id": "seg_event_management",
    "slug": "event-management",
    "label": "Event management",
    "emoji": "🎪",
    "description": "Studios and agencies that plan, design and run events end to end.",
    "company_count": 1284,
    "parent_slug": null,
    "keywords": [
      "event planning",
      "event design",
      "production"
    ]
  },
  "neighbours": [
    {
      "id": "seg_catering",
      "slug": "catering",
      "label": "Catering",
      "emoji": "🍽️",
      "description": "Caterers serving events and venues.",
      "company_count": 951,
      "parent_slug": null,
      "keywords": [
        "catering",
        "banqueting"
      ]
    }
  ],
  "children": [
    {
      "id": "seg_wedding_planners",
      "slug": "wedding-planners",
      "label": "Wedding planners",
      "emoji": "💐",
      "description": "Independent planners and studios producing weddings.",
      "company_count": 376,
      "parent_slug": "event-management",
      "keywords": [
        "wedding",
        "planner"
      ]
    }
  ],
  "sample": [
    {
      "id": "cmp_3h8q1w6x0m4v9k2t7b",
      "domain": "harlowmeadow.example",
      "name": "Harlow Meadow Events",
      "legal_name": "Harlow Meadow Events LLC",
      "description": "Full-service event design studio for weddings and corporate galas.",
      "ultimate_profile": "Designs and installs floral and lighting schemes for 60–90 events a year across the north-east US.",
      "industry_nace": "N82.30",
      "industry_labels": [
        "Event management",
        "Event design"
      ],
      "employee_count": 24,
      "employee_range": "11-50",
      "revenue_range": "$1M-$10M",
      "founded_year": 2011,
      "country": "US",
      "country_name": "United States",
      "region": "north-america",
      "city": "Providence",
      "address": "100 Sample Street",
      "lat": 41.824,
      "lng": -71.4128,
      "website": "https://harlowmeadow.example",
      "linkedin_url": "https://www.linkedin.example/company/harlow-meadow-events",
      "logo_url": null,
      "tech_stack": [
        "HubSpot",
        "Squarespace",
        "Stripe"
      ],
      "socials": {
        "instagram": "https://instagram.example/harlowmeadow"
      },
      "funding": null,
      "registry": {
        "number": "RG421887",
        "status": "active"
      },
      "gmaps": {
        "rating": 4.8,
        "reviews": 214
      },
      "sources": [
        "website",
        "linkedin",
        "gmaps"
      ],
      "quality_score": 91,
      "updated_at": "2026-08-14T09:12:44.000Z"
    }
  ]
}
GET/v1/geo

Coverage by geography

Company, place and people counts per region and per country, counted from the rows actually loaded — the honest answer to "how much do you have in my market". Until the data catalog is loaded, every count is zero and countries is empty.

API key or sessionFree
curl "https://beamro.com/api/v1/geo" \
  -H "x-api-key: $SALVO_API_KEY"
200 response
{
  "regions": [
    {
      "slug": "north-america",
      "name": "North America",
      "countries": 3,
      "companies": 18420,
      "places": 40115
    },
    {
      "slug": "europe",
      "name": "Europe",
      "countries": 44,
      "companies": 21760,
      "places": 38940
    }
  ],
  "countries": [
    {
      "code": "US",
      "name": "United States",
      "region": "north-america",
      "flag": "🇺🇸",
      "companies": 15960,
      "places": 34870,
      "people": 92410
    },
    {
      "code": "GB",
      "name": "United Kingdom",
      "region": "europe",
      "flag": "🇬🇧",
      "companies": 3520,
      "places": 5910,
      "people": 17640
    }
  ]
}
GET/v1/industries

List industries

NACE-coded industry roll-up with company counts, for building pickers and market maps. Empty until the data catalog is loaded.

API key or sessionFree
curl "https://beamro.com/api/v1/industries" \
  -H "x-api-key: $SALVO_API_KEY"
200 response
{
  "rows": [
    {
      "nace": "N82.30",
      "label": "Organisation of conventions and trade shows",
      "emoji": "🎪",
      "companies": 1284
    },
    {
      "nace": "I55.10",
      "label": "Hotels and similar accommodation",
      "emoji": "🏨",
      "companies": 3906
    }
  ]
}