Skip to content

API.md

Latest commit

 

History

History
127 lines (96 loc) · 3.37 KB

API.md

File metadata and controls

127 lines (96 loc) · 3.37 KB

Data Export & API Documentation

The trade show world map data is available as JSON format for analysis, integrations, and applications.

Data Format

JSON (Full Dataset)

The data is structured as an array of show objects.

File: data/b2b_shows.json

Direct URL: https://lensmorofficial.github.io/trade-show-world-map/data/b2b_shows.json

Sample structure:

[
  {
    "name": "MEDICA",
    "website": "https://www.medica.de",
    "city": "Düsseldorf",
    "country": "Germany",
    "venue": "Messe Düsseldorf",
    "start_date": "2026-11-16",
    "end_date": "2026-11-19",
    "frequency": "Annual",
    "industry": "Healthcare & Medical",
    "region": "Europe",
    "tier": 1,
    "lat": 51.2615,
    "lng": 6.7602
  }
]

Note: The JSON file contains an array of show objects (not wrapped in a shows key).

Data Fields

Field Description
name Official show name
website Official website URL
city Host city
country Host country
venue Exhibition venue
start_date Start date (YYYY-MM-DD)
end_date End date (YYYY-MM-DD)
frequency Annual / Biennial / Triennial
industry Industry category
region Geographic region
tier 1=Global flagship, 2=Regional leader, 3=Specialized
lat Latitude
lng Longitude

Usage Examples

Example: Fetch all Tier 1 healthcare shows

fetch('https://lensmorofficial.github.io/trade-show-world-map/data/b2b_shows.json')
  .then(r => r.json())
  .then(shows => {
    const healthcareShows = shows.filter(s => 
      s.industry === 'Healthcare & Medical' && s.tier === 1
    );
    console.log(healthcareShows);
  });

Example: Find shows in Q2 2026

fetch('https://lensmorofficial.github.io/trade-show-world-map/data/b2b_shows.json')
  .then(r => r.json())
  .then(shows => {
    const q2Shows = shows.filter(s => {
      const date = new Date(s.start_date);
      return date >= new Date('2026-04-01') && date <= new Date('2026-06-30');
    });
    console.log(q2Shows);
  });

Data License

The show data is licensed under CC BY 4.0.

You are free to:

  • Use the data for any purpose, including commercial use
  • Modify and build upon the data
  • Distribute the data

Requirement:

Example attribution:

Trade show data provided by Lensmor under CC BY 4.0.

Data Freshness

  • Update frequency: Monthly
  • Last updated: See commit history
  • Verification method: Official show websites and verified industry sources

Contributing Data

Found a show that's missing? See CONTRIBUTING.md for how to add new shows or update existing entries.

Use Cases

Common ways teams use this data:

  • Annual planning: Import into spreadsheets for show selection scoring
  • CRM integration: Enrich account records with upcoming relevant shows
  • Marketing automation: Trigger campaigns based on show proximity
  • Sales intelligence: Alert reps when target accounts are exhibiting
  • Competitive monitoring: Track which shows competitors are attending

Support

For data corrections, additions, or questions: