get_contacts

get_contacts is the explicit outreach lookup. Call it when you are ready to write, not on every SERP row.

Provide at least one of domain, email, or url. A publisher URL is reduced to its host. YouTube, Instagram, and TikTok URLs never fall back to the platform host. A watch or reel URL with no creator match is a miss.

The address lives in value on contact rows, and in email on creator rows.

Get stored contacts for getalai.com. Then try this YouTube watch URL and tell me if it is a miss.

Arguments

Request

Publisher:

{ "domain": "getalai.com" }

YouTube row from SERP:

{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ" }

Response

{
  "status": "found",
  "query": { "domain": "getalai.com", "email": null },
  "matches": [
    {
      "kind": "contact",
      "value": "founders@getalai.com",
      "domain": "getalai.com",
      "position": null,
      "source": "CONTACT_FINDER"
    },
    {
      "kind": "contact",
      "value": "krishna@getalai.com",
      "domain": "getalai.com",
      "first_name": "Krishna",
      "last_name": "Gupta",
      "position": "Co-Founder",
      "source": "HUNTER_IO"
    }
  ]
}

Watch URL, no channel match — not youtube.com staff mail:

{
  "status": "miss",
  "query": {
    "domain": null,
    "email": null,
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  },
  "matches": []
}

Draft in the user’s mail client. LinkDR does not send the message.

What to explore next

• get_keyword_serp for the ranking rows to pitch
• search_creators when you only have a name
• Keyword fan-out