Completion
Retrieve an LLM completion or queue a conversation for later retrieval.
Query parameters
The identifier returned by this endpoint of the queued conversation to retrieve; if given, all other params are ignored; either an ID or prompt is required.
The question or instruction to use as a chat prompt; the prompt requires form or URL encoding (with any space character being replaced by a + character or %20 sequence); either a prompt or ID is required.
The AI model to chat with.
The name as returned by the devices resource of the device to emulate chatting on (these names are case insensitive but must include form- or URL-encoded spaces and punctuation marks); device emulation is unused by default.
The two-letter ISO code of the country to chat from (these codes are case insensitive); a random country is used by default.
The alphanumeric second part (proceeding the separator) of a first-level subdivision code in the (prerequisite) country to chat from (these codes are case insensitive); a random subdivision is used by default.
The commonly spelled name of the city in the (prerequisite) country to chat from (these names are temporarily case sensitive and required to include form- or URL-encoded spaces and punctuation marks); a random city is used by default.
[Planned] The commonly spelled name or two-letter ISO code of the language to chat in (these names and codes are case insensitive but required to include form- or URL-encoded spaces and punctuation marks); the language is unset by default.
[Planned] The commonly spelled name or two-letter ISO code of the chat interface’s display language (these names and codes are case insensitive but required to include form- or URL-encoded spaces and punctuation marks); the display language is unset by default or set to the language if given.
The format to output to.
The age in days of when to consider a cached completion expired, where 0 disables caching.
The synchronous or asynchronous mode of completion retrieval (retrieve an async completion by providing the returned ID).
The encoded HTTP or HTTPS callback URL or Amazon SQS queue URL or ARN to notify when the (prerequisite) async completion has been retrieved; any SQS queue must grant sqs:SendMessage permission to the arn:aws:iam::180363035301:role/api-instance AWS principal.
Response
The AI completion.
Example response
{
"model": "chatgpt",
"query": "best basketball shoes for 2026",
"html": "<!DOCTYPE html><html lang=\"en-US\" ...",
"prompt": "<h4 class=\"sr-only select-none\">You said: ...",
"completion": "<h4 class=\"sr-only select-none\">ChatGPT said: ...",
"sources": "<section aria-label=\"Sources\" ...",
"ads": "<div class=\"border-token-border-default mt-2 border-t py-4 text-sm\" ...",
"sse": "{\"type\": \"conversation_detail_metadata\" ...",
"fanouts": [
"best basketball shoes 2026",
"top rated basketball shoes 2026 reviews",
"best performance basketball shoes 2026",
"best basketball shoes for guards 2026",
"best basketball shoes for wide feet 2026",
"best outdoor basketball shoes 2026",
"most popular basketball shoes 2026"
]
}