Get usage
/v1/usageReturns API call counts for the current billing period, plus a per-endpoint breakdown showing which endpoints have the most usage.
period_start- start of the current billing cycle.period_end- end of the current billing cycle (next renewal date).totals- counts of calls in[period_start, now]. Right after a renewal, all counts will be near 0.
For accounts created before billing-period tracking was added, the window may fall back to a rolling 30-day lookback.
No charge per call.
Pass Authorization: Bearer <api_key>. Preferred for new integrations.
In: header
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/usage" \ -H "Authorization: Bearer YOUR_API_KEY"{ "period_start": "2026-03-31T00:00:00Z", "period_end": "2026-04-30T00:00:00Z", "totals": { "api_calls": 4287, "events_searched": 3886, "salesdata_pulls": 312, "listings_pulls": 89, "stats_pulls": 0, "daily_csv_downloads": 0 }, "by_endpoint": [ { "endpoint": "events.search", "count": 3886 } ]}Get account GET
Returns the user's identity, all active subscriptions, and a static rate-limit catalog.
Search events GET
Modern replacement for the v0.3.1 POST search. Returns event metadata with standardization (normalized venue name, country, lat/lng, slug, performer, tour name) flattened into each item. Use this to discover `event_id` values for the paid stats endpoint. No charge per call. ## Pricing principle This endpoint returns metadata only - never time-series or aggregate data derived from observed marketplace activity. Sales/listings data is paid via the dedicated endpoints. ## Pagination Cursor-based. Pass `starting_after` with the value from `next_cursor` to fetch the next page. Cursors expire after 1 hour.