List Prompts

GET

https://api.webflow.com/beta/sites/:site_id/aeo/prompts

Lists the site’s tracked prompts, with each prompt’s topic and status. Leaves out archived prompts unless you set status.

Results are sorted by createdAt, newest first. To get the next page, pass nextCursor as cursor.

AEO analytics entitlement required

This endpoint requires a site or workspace with the AEO analytics entitlement, and Webflow AI must be enabled for the workspace.

Concurrency limit: 1 request at a time

Each access token can have one AEO request in flight at a time, across all AEO Analytics endpoints. Additional concurrent requests return 429 Too Many Requests; wait for your in-flight request to finish, or for the Retry-After interval, then retry.

Required scope | sites:read

Lists the site's tracked prompts, with each prompt's topic and status. Leaves out archived prompts unless you set `status`. Results are sorted by `createdAt`, newest first. To get the next page, pass `nextCursor` as `cursor`. <Warning title="AEO analytics entitlement required">This endpoint requires a site or workspace with the AEO analytics entitlement, and Webflow AI must be enabled for the workspace.</Warning> <Note title="Concurrency limit: 1 request at a time">Each access token can have one AEO request in flight at a time, across all AEO Analytics endpoints. Additional concurrent requests return `429 Too Many Requests`; wait for your in-flight request to finish, or for the `Retry-After` interval, then retry.</Note> Required scope | `sites:read`

Authentication

AuthorizationBearer

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

Path parameters

site_idstringRequiredformat: "objectid"

Unique identifier for a Site

Query parameters

topicIdstringOptionalformat: "objectid"

Include only prompts in this topic. A topic that isn't on this site returns no prompts.

statusenumOptional

Include only prompts with this status. all includes every status. Omit it to include every status except archived.

Allowed values:

limitintegerOptional1-100Defaults to 50

The maximum number of prompts to return. Defaults to 50, up to 100.

cursorstringOptional

The nextCursor from the previous page.

Response

A page of prompts.

itemslist of objects

The prompts, sorted by createdAt, newest first.

nextCursorstringOptional

Pass this as cursor to get the next page. Present whenever the page is full, so the next page can be empty. Omitted on a page that isn’t full.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error