Documentation

Everything you need to integrate and use our APIs

Getting Started

  1. Sign up for a free account
  2. Create an API key from your dashboard
  3. Browse available APIs and choose one to integrate
  4. Make your first API call using the examples provided
  5. Monitor your usage in the dashboard

Authentication

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

Authorization: Bearer YOUR_API_KEY

You can also pass the API key as a query parameter:

?api_key=YOUR_API_KEY

Making Requests

All API endpoints follow this URL structure:

https://priyanshuapi.xyz/api/runner/{api-slug}/{endpoint}

Example: Text Analyzer

curl -X POST https://priyanshuapi.xyz/api/runner/text-analyzer/analyze \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "This is amazing!"}'

Rate Limits

Rate limits vary by plan. Check the response headers for your current limits:

  • X-RateLimit-Limit: Total requests allowed
  • X-RateLimit-Remaining: Remaining requests
  • X-RateLimit-Reset: When the limit resets

When you exceed your rate limit, you'll receive a 429 Too Many Requests response.

Error Handling

API errors return appropriate HTTP status codes and error messages:

200Success
400Bad Request - Invalid parameters
401Unauthorized - Invalid API key
429Too Many Requests - Rate limit exceeded
500Server Error

Client Libraries

We provide code examples for popular languages on each API's documentation page:

  • cURL
  • JavaScript (fetch & axios)
  • Python (requests)
  • PHP (cURL)
  • Java (HttpClient)

Need Help?

If you have any questions or need assistance: