Submit an async analysis request
Submit a single prompt for asynchronous analysis across selected providers and ISO location codes. The analysis is scoped to the project associated with the authenticated API key. This endpoint is gated behind special access. Contact support to enable async analysis for your organization.
POST /async-analysis
Submit an async analysis request
Submit a single prompt for asynchronous analysis across selected providers and ISO location codes. The analysis is scoped to the project associated with the authenticated API key. This endpoint is gated behind special access. Contact support to enable async analysis for your organization.
Authentication: API key required (Bearer token)
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
prompt | string | Yes | The search prompt to analyze across selected providers and locations (max 5,000 characters). |
replicates | integer | Yes | Number of replicates to run per provider-location pair. Total credits reserved = replicates × providers.length × locations.length. |
providers | array | Yes | Provider IDs to run for this async analysis. Invalid provider-location combinations are rejected with a 400 error. |
locations | array | Yes | ISO 3166-1 alpha-2 location codes to run for this async analysis. Invalid provider-location combinations are rejected with a 400 error. |
webhook | object | No | Optional webhook configuration. When provided, the webhook is called on both analysis success and failure, with automatic retries for up to 24 hours if delivery fails. |
Request Example
curl -X POST https://sellm.io/api/v1/async-analysis \
-H "Authorization: Bearer sellm_your_api_key_here" \
-H "Content-Type: application/json"Responses
| Status | Description |
|---|---|
202 | Async analysis accepted for processing. The analysis has been queued but has not necessarily started yet. Use the GET endpoint to poll for status and results. |
400 | Bad request |
401 | Unauthorized |
403 | Feature not enabled or credits exceeded |
404 | Project not found |
429 | Rate limited |
500 | Internal error |