AskYourSiteAskYourSite Docs

API Overview

The AskYourSite API lets you embed AI-powered chat into your own applications, query your assistant programmatically, and build custom integrations.

Base URL

All API requests are made to:

https://askyoursite.in/api

Authentication

All API requests require authentication. See Authentication for details.

Rate Limits

EndpointLimit
/api/chat10 requests / minute per IP
All other endpoints60 requests / minute per API key

Rate limit headers are included in every response:

X-RateLimit-Limit: 10 X-RateLimit-Remaining: 7 X-RateLimit-Reset: 1712401800

When you exceed the rate limit, the API returns 429 Too Many Requests.


Response Format

All API responses are JSON. Successful responses follow this structure:

json
{
  "data": { ... },
  "error": null
}

Error responses:

json
{
  "data": null,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  }
}

Common HTTP Status Codes

CodeMeaning
200Success
400Bad request — check your request body
401Unauthorized — invalid or missing API key
404Not found — assistant or resource doesn't exist
429Rate limit exceeded
500Internal server error — contact support

Available Endpoints

See Endpoints for a full reference of all available API calls.


Need Help?

If you run into issues, email ravitej@askyoursite.in with:

  • The endpoint you're calling
  • Your request body (redact the API key)
  • The response you received