API Documentation

Comprehensive guides and references for all APIs in our marketplace

🚀 Getting Started

Authentication

All API requests require authentication using your API key. Include it in the header:

X-API-Key: your_api_key_here

Base URL

All API endpoints are available at:

https://apistore.store/api/endpoints/

Response Format

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

{
  "success": true,
  "data": { ... },
  "message": "Success message",
  "timestamp": "2025-01-10T10:00:00Z"
}

🌤️ Weather API

Current Weather

Get current weather conditions for any location:

GET /api/endpoints/weather.php?endpoint=current-weather&location=London

Weather Forecast

Get 5-day weather forecast:

GET /api/endpoints/weather.php?endpoint=weather-forecast&location=Paris

💰 Finance API

Currency Converter

Convert between different currencies:

GET /api/endpoints/finance.php?endpoint=currency-converter&from=USD&to=ZAR&amount=100

Stock Prices

Get real-time stock prices:

GET /api/endpoints/finance.php?endpoint=stock-price&symbol=AAPL

🤖 AI & ML API

Text Generation

Generate text using AI:

POST /api/endpoints/ai.php?endpoint=text-generation
{
  "prompt": "Write a short story about...",
  "max_tokens": 100
}

Sentiment Analysis

Analyze sentiment of text:

POST /api/endpoints/ai.php?endpoint=sentiment-analysis
{
  "text": "I love this product!"
}

⚠️ Error Handling

HTTP Status Codes

200 - Success
400 - Bad Request
401 - Unauthorized
403 - Forbidden
404 - Not Found
429 - Rate Limited
500 - Server Error

Error Response Format

{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE",
  "timestamp": "2025-01-10T10:00:00Z"
}

⏱️ Rate Limiting

API calls are rate limited based on your subscription plan:

Free

1,000 calls/month

Starter

5,000 calls/month

Pro

50,000 calls/month

Premium

1,000,000 calls/month

Rate limit headers are included in responses:

X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4999
X-RateLimit-Reset: 1640995200