Skip to main content
Access web search queries that AI providers generate when responding to prompts. This reveals what searches AI platforms perform to gather information before answering.

​
List Search Insights

​
Authorization
string
required
Bearer token. Example: Bearer qw-api-xxx
GET /api/v1/brands/{brandId}/search

​
Path Parameters

​
brandId
string
required
The unique identifier of the brand

​
Query Parameters

​
period
number
Number of days to include. If not specified, returns all data.
​
startDate
string
Start date (ISO 8601 format)
​
endDate
string
End date (ISO 8601 format)
​
provider
string
Filter by AI provider
​
limit
number
default:"50"
Maximum number of queries to return (max: 100)
​
offset
number
default:"0"
Number of results to skip for pagination
​
sort
string
default:"createdAt"
Field to sort by: createdAt, query
​
order
string
default:"desc"
Sort order: asc or desc

​
Response

​
success
boolean
Indicates if the request was successful
​
pagination
object
​
searches
array

​
Example Request

curl -X GET "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/search?limit=10" \
  -H "Authorization: Bearer qw-api-your-token-here"

​
Example Response

{
  "success": true,
  "pagination": {
    "total": 320,
    "count": 2,
    "limit": 10,
    "offset": 0
  },
  "searches": [
    {
      "id": "srch1",
      "query": "best CRM software 2024 enterprise features comparison",
      "prompt": "What is the best CRM for enterprise?",
      "createdAt": "2024-12-15T10:30:00Z"
    },
    {
      "id": "srch2",
      "query": "Acme CRM vs Salesforce pricing",
      "prompt": "Compare Acme CRM to Salesforce",
      "createdAt": "2024-12-15T09:15:00Z"
    }
  ]
}
Search queries reveal valuable keyword and intent data. Use this to understand what terms AI platforms associate with your industry.

​
Error Responses

StatusCodeDescription
401INVALID_TOKENAuthentication failed
404BRAND_NOT_FOUNDBrand doesn’t exist or not accessible