Case actions

A ready-to-send message for a case from a template

Fills a template with one case (advertiser domain, affiliate ID, dates seen, number of observations, search terms, the five newest observations, your brand and trademark) and returns the subject, the plain-text body and, when short enough, a mailto link. Without template_id it uses the first default for the case's audience (affiliate cases and policy cases with an affiliate ID: affiliates; others: advertisers). recipient is optional and only goes into the mailto link. 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. After the person sends it, call record_outreach_sent. 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}/outreach-message

Request

  • Base URL: https://adslighthouse.com/api/v1
  • URL: https://adslighthouse.com/api/v1/projects/{project_id}/outreach-message
  • 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

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.

template_idstring

The template id from list_outreach_templates.

recipientstring

Response

A ready-to-send message for a case from a template

subjectstring required
bodystring required
mailtostring nullable required

null when the message is too long for a mail link.

request_idstring

Changes

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