Skip to main content
POST
/
post_query
Retrieve top content tiles for a query
curl --request POST \
  --url https://api.webless.ai/post_query \
  --header 'Content-Type: application/json' \
  --data '
{
  "query": "What does Webless do?",
  "company": "YOUR_COMPANY",
  "requestId": "1f7c5f74-7b9e-4a0a-9b7d-4e3e2a5e3b60",
  "sessionId": "a1c2d3e4-1111-2222-3333-444455556666"
}
'
{
  "responses": [
    {
      "id": "<string>",
      "link": "<string>",
      "score": 123,
      "image": "<string>",
      "title": "<string>",
      "description": "<string>",
      "label": [
        "<string>"
      ],
      "gated": 123,
      "multiplier": 123
    }
  ]
}
Use the same requestId and sessionId for post_query, the WebSocket summary stream, dynamic_cta, and get_suggestions for a single user action.

Body

application/json
​
query
string
required

The user query.

Example:

"What does Webless do?"

​
company
string
required

The company identifier provisioned by Webless.

Example:

"YOUR_COMPANY"

​
requestId
string
required

Correlation ID for the request.

Example:

"1f7c5f74-7b9e-4a0a-9b7d-4e3e2a5e3b60"

​
sessionId
string
required

Stable session ID for the user session.

Example:

"a1c2d3e4-1111-2222-3333-444455556666"

​
number_of_tiles
integer
default:6

Maximum number of tiles to return.

Example:

6

​
summary_word_limit
integer
default:120

Target summary length.

Example:

120

​
markdown
boolean
default:false

Whether the response should prefer markdown formatting.

Example:

true

Response

Top matching tiles

​
responses
object[]