order_audit

Order one audit for a brand or person of the account: brand audit, personal audit, Wikipedia notability check, website analysis, Brand ORM status report or Personal ORM status report (reserves credits)

Same behavior as the MCP tool order_audit.

post/v1/audits

Request

  • Base URL: https://api.buzzdealer.ai
  • URL: https://api.buzzdealer.ai/v1/audits
  • Auth: HTTP bearer

Request body

audit_type'brand_audit' | 'personal_audit' | 'wikipedia_notability' | 'website_analysis' | 'brand_orm' | 'personal_orm' required

brand_audit (sentiment, authority and discoverability scores for a brand), personal_audit (the same scores for a person), wikipedia_notability (whether the brand or person is likely notable enough for Wikipedia), website_analysis (an analysis report of one website), brand_orm (Brand ORM status report: where a brand's online reputation stands now, in search, AI answers and the press), personal_orm (Personal ORM status report: the same for a person)

brand_idstring uuid required

The brand or person of this account the audit is about (listed in the dashboard under Brands); the report is kept with it. Items for an unverified brand wait for its verification before fulfilment

namestring

The brand or person name to audit; defaults to the brand's name

websitestring

https link; for website_analysis the website to analyse (required when the brand has no website)

relationship'myself' | 'my_company' | 'client'

personal_audit only, required: who the person is to you: myself, my_company (someone in my company) or client (a client I represent)

rolestring

personal_audit only, optional: the person's role, for example "CEO, Acme"

idempotency_keystring required

A unique value per audit order; send it again only to retry the same order

Response

Success

object required

Changes

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