API Documentation

Public read-only data API for AI agents and RAG systems

Quick Start

# 获取全部数据（展会 + 展商 + 服务商）
curl https://exposoon.com/api/public/dataset?type=all

# 仅获取展会数据
curl https://exposoon.com/api/public/dataset?type=exhibition

# 按行业过滤
curl "https://exposoon.com/api/public/dataset?type=exhibition&industry=电子"

API Endpoints

Method	Path	Description
GET	/api/public/dataset?type=all	All data combined (exhibitions + exhibitors + service providers)
GET	/api/public/dataset?type=exhibition	All exhibition data
GET	/api/public/dataset?type=exhibitor	All exhibitor data
GET	/api/public/dataset?type=service_provider	All service provider data
GET	/api/public/schema	API data dictionary (self-describing schema)

Query Parameters

Parameter	Type	Default	Description
type	exhibition \| exhibitor \| service_provider \| all	all	Data type, defaults to all
q	string	—	Full-text keyword search across name fields
industry	string	—	Filter by industry (e.g., ?industry=电子)
country	string	—	Filter by country
city	string	—	Filter by city
limit	number	100	Number of results (max 500)
offset	number	0	Pagination offset

Response Format

exhibitions / exhibitors / service_providers: entity arrays, returned by type
_links: each entity includes self URL and related entity URLs
_rag_text: pre-concatenated semantic text for RAG embedding
_meta: schema version, field descriptions, counts and pagination info

{
  "exhibitions": [ { "id": 1, "name_cn": "...", "name_en": "...", "_links": { "self": "...", "exhibitors": "...", "providers": "..." }, "_rag_text": "..." } ],
  "exhibitors":    [ { "id": 1, "company_cn": "...", "company_en": "...", "_links": { "self": "...", "exhibitions": ["..."] }, "_rag_text": "..." } ],
  "service_providers": [ { "id": 1, "name_cn": "...", "name_en": "...", "_links": { "self": "..." } } ],
  "_meta": {
    "type": "all",
    "schema_version": "1.0",
    "count": 123,
    "generated_at": "2026-01-01T00:00:00.000Z",
    "base_url": "https://exposoon.com",
    "entities": { "...": "auto-generated field schema" }
  }
}

Data Schema

Entity	Key Fields
Exhibition	id, name_cn, name_en, industry_tags_cn, industry_tags_en, country, city, start_date, end_date, status, organizer, venue, official_url
Exhibitor	id, company_cn, company_en, industry_tags, product_tags, intro, exhibit_history, tags, weight, official_url
Service Provider	id, name_cn, name_en, service_types, cover_regions, good_at_industry, intro, case_images, is_verified

See GET /api/public/schema (_meta.entities) for the full auto-generated field dictionary.

Usage Examples

# 获取即将举办的展会
curl "https://exposoon.com/api/public/dataset?type=exhibition&q=upcoming"

# 按行业搜索展会
curl "https://exposoon.com/api/public/dataset?type=exhibition&industry=电子"

# 分页获取展商
curl "https://exposoon.com/api/public/dataset?type=exhibitor&limit=50&offset=0"

# 获取 API 数据字典
curl https://exposoon.com/api/public/schema

Rate Limiting

Cache-Control: public, max-age=300 (5 minutes). Public data refreshes every 5 minutes; clients should respect cache headers to reduce repeated requests. No authentication required — readable directly by AI agents and RAG systems.