Background
Image
English

Mint Social API Documentation

Version: v1.0


Base URL: https://api.mintsocial.com/

Protocol: HTTPS (Secure REST API)

Format: JSON


Overview

The Mint Social API allows developers to integrate and interact with the platform’s core features, including user profiles, posts, jobs, and marketplace listings. It is designed to enable seamless connectivity between Mint Social and third-party applications, websites, and services.


Authentication

All API requests require authentication using an API key or Bearer Token.


Header Example:

Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json

Unauthorized requests will return:

401 Unauthorized


Rate Limits

To ensure platform stability, API usage is limited:

  1. 100 requests per minute per API key
  2. 10,000 requests per day

Exceeding limits will return:

429 Too Many Requests


Endpoints

1. Users

Get User Profile

GET /users/{id}


Response:

{
"id": "123",
"name": "John Doe",
"username": "johndoe",
"bio": "Entrepreneur",
"created_at": "2026-01-01"
}

2. Posts

Create Post

POST /posts


Body:

{
"content": "Hello from Mint Social!",
"visibility": "public"
}


Get Posts Feed

GET /posts


3. Jobs


Create Job Listing

POST /jobs

Body:

{
"title": "Marketing Manager",
"company": "ABC Corp",
"location": "Remote",
"description": "We are hiring..."
}


Search Jobs

GET /jobs?keyword=marketing&location=remote


4. Marketplace


Create Listing

POST /marketplace

Body:

{
"title": "Web Design Services",
"price": 500,
"description": "Professional website design",
"category": "services"
}


Browse Listings

GET /marketplace


Error Handling

The API uses standard HTTP status codes:

  1. 200 – Success
  2. 400 – Bad Request
  3. 401 – Unauthorized
  4. 403 – Forbidden
  5. 404 – Not Found
  6. 429 – Rate Limit Exceeded
  7. 500 – Server Error

Error Response Example:

{
"error": "Invalid request",
"code": 400
}


Pagination

Endpoints that return lists support pagination:

GET /posts?page=1&limit=20


Webhooks (Optional)

Mint Social supports webhooks for real-time updates.


Examples:

  1. New user registered
  2. New job posted
  3. New marketplace listing


Security

  1. All requests must use HTTPS
  2. API keys must be kept confidential
  3. Unauthorized use may result in suspension


Best Practices

  1. Cache responses where possible
  2. Handle rate limits gracefully
  3. Validate all inputs before sending requests


Support

For API access, keys, or integration support:


Mint Social

Email: support@mintsocial.io

Website: www.mintsocial.io


Future Updates

Upcoming API features may include:

  1. Messaging endpoints
  2. Payment integration for marketplace
  3. Advanced analytics
  4. AI-powered content tools