Local listing audit (AEO starter)

Audits one business listing using its name and location. Domains, website URLs, and page URLs are not business names and are rejected before charging. The legacy domain field accepts business-name text only during migration.

post/audit/local

Request

  • Base URL: https://www.agentseo.dev/api/v1
  • URL: https://www.agentseo.dev/api/v1/audit/local
  • Auth: API key in header x-api-key

Query parameters

syncboolean

Open a short inline processing window when supported by the endpoint. If the result is not ready yet, the endpoint may still return 202 with a queued payload that includes poll_url, events_url, and retry_after_seconds.

Headers

x-project-idstring

Optional attribution label for grouping usage and jobs by project.

x-workflow-idstring

Optional attribution label for grouping usage and jobs by workflow or agent run.

Request body

business_namestring required

Business name as shown on Google Maps. Website domains and URLs are not accepted. Legacy clients may pass a business name in domain during the compatibility window.

locationstring required

City, state, and country to geo-target the listing lookup.

languagestring

Response

Completed local audit with agent_workflow

business_namestring
ratingnumber
review_countinteger
addressstring
knowledge_graphobject
aeo_auditobject
agent_briefobject
markdown_summarystring

Changes

No recorded changes to this operation across all 1 revision of this API.