Introduction

Calling conventions

The Web API consists of HTTP request-response methods, all of form https://api.taggun.io/api/{group}/v1/{method}

All methods are implemented in a synchronous fashion which holds the connection open until the response is delivered or the timeout period expires. There are no webhooks or deferred callback mechanisms.

All responses contain a JSON object and header with content-type: application/json; charset=utf-8

All API requests must be made over HTTPS.

Authentication

Authenticate your account with your request by including apikey in the request header.

Keep your API keys secret. Do not distribute your API key in native applications, client-side JavaScript, or public code repositories.

See here for code examples

Admin access

You can view your API usage, cancel or update your credit card number here.

API Status

The status page reports the uptime and response time for Taggun's API.

Usage limits

Taggun enforces the following usage limits:

Type of limit	Usage limit
MB per request	20mb
Requests per second	5
Requests per minute	300
Requests per hour	2000