Case actions

What a platform's trademark complaint form asks for, from one case

Builds the complaint package for one case and platform (google_ads or microsoft_advertising): trademark and owner (from get_trademark_details), advertiser domain, affiliate ID, ad headlines and text, display and destination URLs, search terms, dates and locations seen, each as a labelled text field to copy into the platform's official form, plus the form and help links. Only observations on that platform's search engine are used (Google for Google Ads, Bing for Microsoft Advertising). Nothing is filed or sent by this tool: Google Ads and Microsoft Advertising have no API for trademark complaints, so the person submits on the platform's own form, and messages are sent from the person's own email. Attach the evidence pack (create_case_evidence_pack) as the supporting document. An observation shows an ad was displayed for a search at a moment; it does not prove a purchased keyword, spend or infringement.

get/projects/{project_id}/complaint-package

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/complaint-package
  • Auth: HTTP bearer

Path parameters

project_idstring required

The project: its id, its brand domain (for example nike.example) or its exact project or brand name. Unknown or ambiguous references return not_found; call list_projects then.

Query parameters

platform'google_ads' | 'microsoft_advertising' required
case_type'policy' | 'affiliate' required

policy for a case from list_policy_cases; affiliate for a non-compliant affiliate case from list_affiliate_findings.

case_idstring

The policy case id. Required when case_type is policy.

affiliate_idstring

The affiliate ID exactly as list_affiliate_findings returns it. Required when case_type is affiliate.

Response

What a platform's trademark complaint form asks for, from one case

platform'google_ads' | 'microsoft_advertising' required
platform_namestring required
form_urlstring required

The platform's official form. Submit there.

trademark_readyboolean required

False until the project has trademark details.

observations_usedinteger required
observations_other_engineinteger required
observations_unknown_engineinteger required
notestring required
textstring required

Every field as one text block.

request_idstring

Changes

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