Powerful API Suite
Advanced web scraping, temporary email services, and secure authentication - more then 500 features, all in one modern API platform
Quick Start
Get started in seconds. Add your API key to any endpoint and receive structured JSON responses with comprehensive error handling.
Request Format
Response Format
Authentication
Secure API access with multiple authentication methods. Most endpoints require an API key, while mail services use bearer tokens for enhanced security.
Query Parameter
?apikey=YOUR_KEY
Standard method for most endpoints
Bearer Token
Authorization: Bearer TOKEN
For mail.tw integration
Common Error Codes
Account Registration
Create Account
{
"name": "John Doe",
"email": "john@example.com",
"password": "strongpassword123"
}{
"status": true,
"creator": "Qasim Ali🩷",
"success": true,
"message": "Verification code sent"
}Verify Account
{
"email": "john@example.com",
"code": "123456"
}{
"status": true,
"creator": "Qasim Ali🩷",
"success": true,
"message": "Account created successfully",
"api_key": "abcd1234efgh5678"
}API Key Management
Check Usage
curl "https://discardapi.dpdns.org/api/key/check?key=YOUR_KEY"
Response
{
"status": true,
"creator": "Qasim Ali🩷",
"message": "Key valid",
"usage": 47,
"limit": 200,
"reset_in": "8 hours"
}Get Key Details
curl "https://discardapi.dpdns.org/api/key/get?key=YOUR_KEY"
Key Metadata
{
"creator":"Qasim Ali🩷",
"key": "abcd1234efgh5678",
"email":"someone@example.com",
"last_reset":"2025-09-18T16:15:53Z",
"limit":1000,
"special":true,
"status":true,
"usage":0
}mailtm Integration
Create temporary email addresses instantly. Perfect for testing, verification, and protecting your privacy. Our system generates randomized addresses using premium domains.
Instant Creation
Generate emails in milliseconds
Secure & Private
No logs, full encryption
Auto-Cleanup
Messages auto-delete after 24h
Get Domains
"https://discardapi.dpdns.org/api/mailtm/domains?apikey=YOUR_KEY"
{
"creator":"Qasim Ali🩷",
"result":{"@context":"/contexts/Domain",
"@id":"/domains",
"@type":"hydra:Collection",
"hydra:member":[{"@id":"/domains/68caf5471dafae81a9e5d315",
"@type":"Domain",
"createdAt":"2025-09-17T00:00:00+00:00",
"domain":"tiffincrane.com",
"id":"68caf5471dafae81a9e5d315",
"isActive":true,
"isPrivate":false,
"updatedAt":"2025-09-17T00:00:00+00:00"}],
"hydra:totalItems":1},
"status":true
}Create Mailbox
curl "https://discardapi.dpdns.org/mailtm/create?apikey=YOUR_KEY&domain=tiffincrane.com"
{
"creator":"Qasim Ali🩷",
"result":{"@context":"/contexts/Account",
"@id":"/accounts/68cd516f19dcf23ccc06b4e4",
"@type":"Account",
"address":"apajnd1l@tiffincrane.com",
"createdAt":"2025-09-19T12:49:51+00:00",
"id":"68cd516f19dcf23ccc06b4e4",
"isDeleted":false,
"isDisabled":false,
"quota":40000000,
"token":"eyJ0eXAiOiJKV1QiLCJhbGci.......",
"updatedAt":"2025-09-19T12:49:51+00:00",
"used":0},
"status":true
}Fetch Messages
"https://discardapi.dpdns.org/mailtm/messages?page=1&token=sometoken......."
{
"status": true,
"messages": [{
"id": "msg_123",
"from": "noreply@service.com",
"subject": "Welcome!",
"body": "Thanks for signing up...",
"received": "2025-09-17T14:30:00Z"
}]
}Pro Tip
Store the token securely and use it for all subsequent message operations. Tokens are valid for 24 hours.
News Enpoints
High-performance News Enpoints for news sites and content extraction.
TRT Headlines
Real-time news headlines with metadata
GET /news/trt?apikey=YOUR_KEY
Sky Sports
Television news updates and breaking stories
GET /news/skysports?sport=boxing&apikey=YOUR_KEY
AlJazeera English
Headlines and full article extraction
GET /news/alJazeera?apikey=YOUR_KEY
GET /alJazeera/article?url=ARTICLE_URL&apikey=YOUR_KEY
CGTN World
Headlines and full article extraction
GET /news/cgtn?apikey=YOUR_KEY
GET /cgtn/article?url=ARTICLE_URL&apikey=YOUR_KEY
Rate Limits
Flexible pricing tiers to match your usage needs. All limits reset every 24 hours at midnight UTC.
Free
- Basic endpoints
- mailtm integration
- Community support
Student
- All endpoints
- Priority support
- Analytics dashboard
Premium
- All endpoints
- Priority support
- Analytics dashboard
VIP
- Dedicated support
- Custom webhooks
- SLA guarantee
Business
- Dedicated support
- Custom webhooks
- SLA guarantee
Enterprise
- Unlimited requests
- White-label option
- Custom integration
Interactive Examples
Code Example
Expected Response
Live Response
Error Handling
Comprehensive error codes with detailed descriptions and resolution steps. All errors include helpful context and suggestions.
Authentication Errors
API key parameter missing
Add ?apikey=YOUR_KEY to your request
Invalid API key provided
Check your key or generate a new one
Some query parameters required
Please provided (query) e.g url
Requires premium API key
Upgrade your account for access
Rate Limiting & System
Rate limit exceeded
Wait for reset or upgrade plan
Internal server error
Temporary issue, try again later
Endpoint or resource not found
Check the URL and parameters
Best Practices
Always check the status field before processing results
Implement exponential backoff for rate limit errors
Log error codes for debugging and monitoring
Handle network timeouts gracefully
Support & Contact
Get in Touch
Need help or want to upgrade? Our team is here to assist you with integration, troubleshooting, and custom solutions.