Skip to main content

Base URL

All API requests should be made to:
https://api.getchatads.com

Authentication

All API endpoints require authentication via the x-api-key header.
curl -H "x-api-key: YOUR_API_KEY" \
  https://api.getchatads.com/v1/chatads/messages
Get your API key from getchatads.com/settings/api-keys.

Request Format

All requests should:
  • Use Content-Type: application/json
  • Include the x-api-key header
  • Send data in JSON format

Response Times

Our API is designed for low-latency inline processing, with response times optimized for different use cases.

Standard

350ms - 600msFull message analysis with keyword extraction, intent scoring, and affiliate link resolution.

Quality = Fast

~150msFaster, with potential accuracy tradeoff. Set quality: "fast" for reduced latency.

Response Format

All responses follow this structure:
{
  "success": boolean,
  "data": object | null,
  "error": object | null,
  "meta": {
    "request_id": string,
    "country": string,
    "language": string,
    "usage": object
  }
}

Endpoints

POST /v1/chatads/messages

Analyze a message for affiliate opportunities

Error Handling

See Error Handling for details on error codes and responses.

Rate Limits

See Rate Limits for information about request quotas.