Skip to main content
GET
/
ai
Completion
curl --request GET \
  --url https://api.agentfirst.dev/ai \
  --header 'Authorization: Bearer <token>'
{
  "model": "chatgpt",
  "prompt": "best basketball shoes for 2026",
  "html": "<!DOCTYPE html><html lang=\"en-US\" ...",
  "promptHtml": "<h4 class=\"sr-only select-none\">You said: ...",
  "completionHtml": "<h4 class=\"sr-only select-none\">ChatGPT said: ...",
  "sourcesHtml": "<section aria-label=\"Sources\" ...",
  "subqueries": [
    "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"
  ],
  "device": null,
  "country": null,
  "subdivision": null,
  "city": null,
  "language (planned)": null,
  "display (planned)": null
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
prompt
string
required

The question or instruction of up to 2,047 characters 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).

Example:

"best basketball shoes for 2026"

​
model
enum<string>
default:chatgpt

The AI model to chat with.

Available options:
chatgpt,
gemini,
perplexity (coming soon),
copilot (coming soon)
Example:

"gemini"

​
device
string

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.

Example:

null

​
country
string

The two-letter ISO code of the country to chat from (these codes are case insensitive); a random country is used by default.

Example:

null

​
subdivision
string

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.

Example:

null

​
city
string

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.

Example:

null

​
language (planned)
string

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.

Example:

null

​
display (planned)
string

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.

Example:

null

​
format
enum<string>
default:json

The format to output to.

Available options:
json,
rendered,
raw
Example:

"rendered"

​
expiration
integer
default:1

The age in days of when to consider a cached completion expired, where 0 disables caching.

Required range: 0 <= x <= 1
Example:

0

​
mode
enum<string>
default:sync

The synchronous or asynchronous mode of completion retrieval (see the async resource).

Available options:
sync,
async
Example:

"sync"

Response

The AI completion.

​
model
enum<string>
required

The AI model that generated the completion.

Available options:
chatgpt,
gemini,
perplexity (coming soon),
copilot (coming soon)
Example:

"chatgpt"

​
prompt
string
required

The user prompt that the completion was generated for.

Example:

"best basketball shoes for 2026"

​
html
string
required

The rendered HTML of the entire conversation.

Example:

"<!DOCTYPE html><html lang=\"en-US\" ..."

​
promptHtml
string
required

The rendered HTML of just the prompt portion of the conversation.

Example:

"<h4 class=\"sr-only select-none\">You said: ..."

​
completionHtml
string
required

The rendered HTML of just the completion portion of the conversation.

Example:

"<h4 class=\"sr-only select-none\">ChatGPT said: ..."

​
sourcesHtml
string
required

The rendered HTML of just the sources portion of the conversation.

Example:

"<section aria-label=\"Sources\" ..."

​
subqueries
string[]
required

The fanout queries that the model searched to generate the completion; only some models expose these queries.

Example:
[
  "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"
]
​
device
string

The name of the targeted emulated device.

Example:

null

​
country
string

The ISO code of the targeted country.

Example:

null

​
subdivision
string

The partial ISO code of the targeted subdivision in the country.

Example:

null

​
city
string

The common name of the targeted city in the country.

Example:

null

​
language (planned)
string

The common name or ISO code of the targeted language.

Example:

null

​
display (planned)
string

The common name or ISO code of the targeted display language.

Example:

null