FAQ

Where do I find my Bitly API token?

Log in to Bitly and go to Settings → Developer settings → API. You'll see your personal access token there. If you haven't generated one yet, click the button to create it. Copy the full token and paste it into Coupler.io when setting up the connection.

Which Bitly plan do I need to use all entities?

Basic entities like Bitlinks, Bitlink clicks, Groups, and Organizations are available on most plans including Free. However, Campaigns, Channels, and Bsds require a paid plan (Teams or higher). If you get a 403 error on those entities, your plan likely doesn't include them.

Can I pull click data for all my Bitlinks at once?

Yes, but with caveats. The Bitlink clicks entity returns click counts across your links for the date range you specify. For accounts with a large number of links, pulling a very wide date range in one go can run into rate limits. It's better to use monthly date ranges and Append mode to build up history incrementally.

Can I combine Bitly data with data from other marketing tools?

Absolutely. Coupler.io supports multiple sources in a single data flow. You can use Join to merge Bitly click data with, say, campaign data from HubSpot or UTM data from Google Analytics. Use Append to stack data from multiple Bitly groups or accounts side by side.

Can I send Bitly data to an AI tool for analysis?

Yes. Coupler.io supports AI destinations including ChatGPT, Claude, Gemini, Perplexity, Cursor, and OpenClaw. You can route your Bitlink clicks or campaign data directly to these tools to generate summaries, spot trends, or draft reports automatically.

Why does my Bitlink clicks entity return empty rows?

This is almost always a date range issue. Bitly's clicks API requires explicit start and end dates — if your date range doesn't cover any period with click activity, you'll get an empty result. Double-check your date pickers and make sure the range overlaps with when your links were active.

What's the difference between Group shorten counts and Organization shorten counts?

Both track how many links were shortened, but at different levels. Group shorten counts shows activity per team or group within your org — useful if you want to see which team is creating the most links. Organization shorten counts rolls that up to the top level for an org-wide view.

Can I track QR code clicks through Coupler.io?

The QR codes entity returns QR code metadata and their associated Bitlink IDs. Click-level data for QR codes flows through the Bitlink clicks entity — join on bitlink_id to connect QR code info to its click performance.

For a full breakdown of available fields per entity, see the Data Overview article. For help with connection errors or missing data, check Common Issues.