Introduction
============

About Taglife
------------

Taglife is a comprehensive social media marketing platform that enables advertisers to create and manage influencer marketing campaigns. The platform connects advertisers with social media influencers and content creators to promote products and services across various social networks.

Platform Features
----------------

- **Campaign Management**: Create, manage, and track marketing campaigns
- **Influencer Discovery**: Find and select relevant social media influencers
- **Task Management**: Assign and track completion of promotional tasks
- **Payment Processing**: Handle payments and payouts to influencers
- **Analytics & Reporting**: Comprehensive analytics and performance tracking
- **Multi-Network Support**: Support for Facebook, Instagram, Twitter, Youtube, Tiktok and other social platforms (optional)

API Overview
------------

The Taglife API is a RESTful API that allows you to integrate with the Taglife platform programmatically. The API provides endpoints for:

- **Campaign Management**: Create, update, and manage campaigns
- **User Management**: Handle user authentication and profiles
- **Social Network Integration**: Connect and manage social media accounts
- **Payment Processing**: Handle payouts and financial transactions
- **Analytics**: Retrieve campaign and user statistics

Base URL
--------

All API requests should be made to the base URL of your Taglife instance:

.. code-block:: text

   https://your-domain.com/api/

Authentication
--------------

The API uses JWT (JSON Web Tokens) for authentication. See the :doc:`authentication` section for detailed information about authentication methods.

Response Format
--------------

All API responses are returned in JSON format with the following structure:

.. code-block:: json

   {
     "status": "success",
     "data": {
       // Response data
     },
     "message": "Optional message"
   }

HTTP Status Codes
----------------

The API uses standard HTTP status codes:

- **200**: Success
- **201**: Created
- **400**: Bad Request
- **401**: Unauthorized
- **403**: Forbidden
- **404**: Not Found
- **500**: Internal Server Error

Rate Limiting
-------------

API requests are subject to rate limiting to ensure fair usage. The current limits are:

- **100 requests per minute** for authenticated users
- **10 requests per minute** for unauthenticated users

Getting Started
--------------

To get started with the Taglife API:

1. Review the :doc:`authentication` section to understand how to authenticate
2. Explore the available :doc:`endpoints/campaigns` for campaign management
3. Check out the :doc:`examples` section for integration examples
4. Refer to the :doc:`data-models` section for detailed data structures

Support
-------

For API support and questions:

- **Email**: api-support@Taglife.com
- **Documentation**: This documentation site
- **Status Page**: https://status.Taglife.com