Linkly's Analytics API

Export click data and traffic reports from Linkly programmatically using our Analytics API.

Related: Link Shortening API | Webhooks

Before you Begin

Linkly generates API requests in the interface for you to copy & paste into your applications.

Save time and let us do the hard work:

  1. Open any traffic report in Linkly.
  2. Copy the API request shown at the top of the report.
  3. Ask ChatGPT or an equivalent to adapt these requests into source code for your application. There is no need to spend time doing a complex integration. Our API is entirely machine-consumable.

Authorization

You will need:

  • Your API Key
  • Workspace ID

You can get these details from inside Linkly.

  1. Login to Linkly.
  2. Click Settings.
  3. Click API Keys.

Traffic Reports API

Linkly automatically produces API requests for you inside your traffic reports.

Linkly's Traffic Reports API
Linkly's Traffic Reports API

Linkly's traffic reports automatically build API requests for you, based on the data shown on the screen.

These links include your API key, and are easily customizable and usable in your own applications.

Raw Click Data

The raw click data we record, including full parameters, timestamps and geolocation information, is available.

To do this, click 'Export' from the tabs at the bottom and choose your format. These are fully formed API requests you can use directly in your application.

Export Raw Data
Export Raw Data
Raw Click Data Example
Raw Click Data Example

Notes Regarding Data Export

  • Consider filtering data in the view first to reduce the amount of data exported. This function exports the underlying data used to generate the report currently on the screen.
  • This data is cached for up to 3 hours. Repeated requests to this endpoint will not produce realtime data.

Real-Time Click Notifications

For real-time click notifications, see Webhooks. Webhooks send a POST request to your specified URL(s) immediately when a click occurs, with detailed information about the click.

You can also manage webhooks via the API - see the OpenAPI spec for details.

Fair Use Policy

Rate Limits

The Analytics API is rate limited to 50 requests per hour per workspace.

Usage Limits

In addition to rate limits, the Analytics API has usage limits that reset each billing period:

Plan Type
API Requests
Data Scanned
Free
100 / month
10 GB / month
Monthly Paid
2,000 / month
2 TB / month
Annual Paid
24,000 / year
24 TB / year
← Scroll →

What Counts as Usage

  • API Requests: Each call to the Analytics API endpoints (/clicks, /counters, /export) counts as one request.
  • Data Scanned: The amount of data processed by our analytics database to fulfill your request. Larger date ranges and more complex queries scan more data.

What Happens When You Exceed Limits

If you exceed your usage limits:

  1. API requests will return a 429 Too Many Requests error
  2. Your limits will automatically reset at the start of your next billing period
  3. Your links will continue to work and track clicks normally

Tips to Reduce Usage

  • Cache responses: Store API responses locally instead of fetching the same data repeatedly
  • Use smaller date ranges: Query only the dates you need
  • Batch requests: Combine multiple link queries into a single request using the link_ids parameter

Need More?

If you need higher limits, please talk to us using the support widget.

BigQuery Integration

For high-volume analytics needs, Linkly offers a BigQuery integration that provides direct SQL access to your click data.

  • Live data access - Query your click data directly in BigQuery with real-time updates
  • Unlimited queries - No API rate limits; you only pay for BigQuery compute
  • Custom reporting - Build dashboards with Looker, Data Studio, or Tableau
  • Data consolidation - Join click data with other business metrics

BigQuery integration is free for Unlimited plan customers, or available as a $100/month add-on for other plans.

Learn more about BigQuery Integration →

Track 1000 monthly clicks with all features included.

No credit card required