Skip to main content
POST
/
v1
/
chatads
/
messages
curl -X POST 'https://api.getchatads.com/v1/chatads/messages' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "message": "What are the best noise-cancelling headphones?"
  }'

{
  "data": {
    "status": "filled",
    "offers": [
      {
        "link_text": "noise-cancelling headphones",
        "url": "https://www.amazon.com/dp/B0XXXXXXXXX?tag=yourtag-20",
        "confidence_level": "high"
      }
    ],
    "requested": 1,
    "returned": 1
  },
  "error": null,
  "meta": {
    "request_id": "d6a8f6f2-3b5a-4f0a-81ab-1b4a4c9dd5ea",
    "country": "US",
    "timing_ms": {
      "total_ms": 222.0,
      "extraction_ms": 214.1
    },
    "usage": {
      "monthly_requests": 250,
      "daily_requests": 20,
      "daily_limit": 100,
      "is_free_tier": true,
      "free_tier_limit": 100,
      "free_tier_remaining": 0
    }
  }
}
Analyzes a user message to extract product keywords and return relevant affiliate links.
Using the API Explorer: Click “Try It” on the right to test this endpoint interactively. Enter your API key from app.getchatads.com/api/keys in the Authorization header field.

​
Request Body

​
message
string
required
The user message to analyze. Required, 1-5000 characters.
​
ip
string
IPv4/IPv6 address for country detection (max 45 characters).
​
country
string
Country code (e.g., ‘US’). If provided, skips IP-based country detection.
​
quality
string
default:"standard"
Variable for playing around with keyword quality, link accuracy, and response times. ‘fast’ = quickest, but less likely to find a working affiliate link (~150ms), ‘standard’ = strong keyword quality and decent link matching (~1.4s), ‘best’ = strong keyword and strong matching (~2.5s).

​
Response

​
data
object
​
error
object
Error details when request fails. Null for successful requests. Check error == null to determine success.
​
meta
object
curl -X POST 'https://api.getchatads.com/v1/chatads/messages' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: YOUR_API_KEY' \
  -d '{
    "message": "What are the best noise-cancelling headphones?"
  }'

{
  "data": {
    "status": "filled",
    "offers": [
      {
        "link_text": "noise-cancelling headphones",
        "url": "https://www.amazon.com/dp/B0XXXXXXXXX?tag=yourtag-20",
        "confidence_level": "high"
      }
    ],
    "requested": 1,
    "returned": 1
  },
  "error": null,
  "meta": {
    "request_id": "d6a8f6f2-3b5a-4f0a-81ab-1b4a4c9dd5ea",
    "country": "US",
    "timing_ms": {
      "total_ms": 222.0,
      "extraction_ms": 214.1
    },
    "usage": {
      "monthly_requests": 250,
      "daily_requests": 20,
      "daily_limit": 100,
      "is_free_tier": true,
      "free_tier_limit": 100,
      "free_tier_remaining": 0
    }
  }
}