Use case

Build a trade show and conference calendar for your sales team

Pull upcoming trade shows, conferences and workshops by topic and country into JSON, to plan which events to attend, sponsor or sell around.

Prepaid, no subscriptionREST or MCPOne key for models, data and agents
10timeslovelyjsonitems[0]"name": "AI Infrastructure Exp…"dates": "2026-11-18 to 2026-11…"venue": "Austin Convention Cen…"city": "Austin""type": "tradeshow""organizer": "Northline Events"

Picking which trade shows to attend, sponsor or book meetings at is a spreadsheet job that is out of date the week after you finish it. Event listings are spread over many pages, and you need them by topic, country and date. Lovely Router reads them from 10times for you. Send a topic and a country, get one JSON object per event, pay per event from a prepaid balance. Call it from a script, a planning sheet or an AI agent with one API key.

Hand it to your AI agent

Copy this prompt into Claude Code, Cursor, Codex or any coding agent. It tells the agent where the docs are and how to use your API key.

Build a trade show and conference calendar for your sales team. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>
01

How it works

010203
  1. Pick the topic and market

    Choose the industry words that match your buyers, a country code or WW for worldwide, and an event type: trade show, conference or workshop.

  2. Run the tool with a cap

    Send them to POST /v1/tools/10times-events/run with maxItems in the input and max_results on the request. The run holds its maximum cost from your balance and returns the events as JSON.

  3. Rank and share

    Sort by date, group by city, and drop the result into your team's calendar or planning sheet. Re-run each quarter to catch new listings.

02

Get a list of events with one request

Find trade shows and conferences takes a topic in query and a country code in country. maxItems caps how many events come back, up to 200 per run:

curl https://lovelyrouter.com/v1/tools/10times-events/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
        "query": "artificial intelligence",
        "country": "US",
        "maxItems": 5
      },
    "max_results": 5
  }'

Add eventType (all, tradeshow, conference or workshop), or startDate and endDate in YYYY-MM-DD; about the next 90 days are listed. A run still going after 60 seconds returns 202; Run a tool shows how to poll.

03

What each event holds

Field groupWhat you get
IdentityEvent name, event type and link
WhenDates
WhereVenue and city
OrganizerThe company running the event

Each run returns upcoming listings only, so treat it as a forward calendar rather than a history of past shows.

04

Recipes

Plan next year's event budget

Search the three topics that match your product in your two biggest markets, cap each at 50 events, and rank by city and date so you can fit them into one travel plan.

Find trade shows to book meetings at

Run eventType set to tradeshow for your industry, then send the list to your sales team with the dates and the organizer, so reps can request meetings before the show.

Sponsor shortlist

Pull conferences by topic, group them by organizer, and see which organizers run several relevant events in the same quarter, which is where a multi-event sponsorship is easier to negotiate.

Virtual event tracker

Set onlineOnly to true, keep country on worldwide, and collect online events to attend without travel.

Monthly digest to the team

Run on the first of each month with a startDate and endDate window, diff against last month's results, and post only the new events to Slack.

Prefer plain words? Connect the MCP server and tell Claude Code or Cursor: "Find conferences about cybersecurity in Germany over the next 90 days, set maxItems to 30, and give me a table of name, dates, city and organizer sorted by date."

06

What you pay

You pay per event: starting a run holds its maximum cost, the per-call fee plus the per-event fee times max_results, and the run settles to what it returned. The rest of the hold goes back to your balance. A run that fails or times out pays only for the events it delivered, and a run refused at the start costs nothing.

Pulling 100 events is billed as 100 events, whether they come from one search or several. There is no subscription and no monthly minimum: top up from $5, and one balance pays for tools and models. The card above shows today's price; pricing lists every tool.

07

Frequently asked questions

?
Can I search by topic and country?+

Yes. query is matched against event names and country takes an ISO code such as US or DE, or WW for worldwide. You can also pass a country name in location.

Which event types can I filter by?+

eventType accepts all, tradeshow, conference or workshop.

How far ahead does it look?+

Start and end dates are optional. The tool lists about the next 90 days from the start date you give.

Can I find online-only events?+

Yes, set onlineOnly to true. Online events are listed worldwide rather than under a country, so leave country on WW when you use it.

How many events can one run return?+

Up to 200 events per run, set with maxItems and max_results. For more, start several runs with different topics or countries.

Do I need a subscription?+

No. You add credit to a prepaid balance and each run draws it down. Failed runs pay only for the results they delivered, and nothing renews automatically.

Building a prospect list from the companies you find? See lead generation, the tool catalog and the MCP server.

One prepaid key for models, data and agents

No subscription. Top up, use what you need, see every charge in your logs.