Skip to main content
POST
/
v1
/
ads
/
google-ads-search
Google Ads Search
curl --request POST \
  --url https://api.leadmagic.io/v1/ads/google-ads-search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "company_domain": "leadmagic.io",
  "company_name": "leadmagic"
}
'
{
  "ads": [
    {
      "advertiser_id": "AR14106062795078369281",
      "creative_id": "CR14003695067076755457",
      "original_url": "https://adstransparency.google.com/advertiser/AR14106062795078369281/creative/CR14003695067076755457?region=anywhere",
      "variants": [
        {
          "content": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/6399633577457746150\" height=\"173\" width=\"380\">",
          "height": 173,
          "width": 380
        }
      ],
      "start": "2024-07-03",
      "last_seen": "2025-03-06",
      "advertiser_name": "LeadMagic Inc",
      "format": "Text"
    },
    {
      "advertiser_id": "AR14106062795078369281",
      "creative_id": "CR16065875974473908225",
      "original_url": "https://adstransparency.google.com/advertiser/AR14106062795078369281/creative/CR16065875974473908225?region=anywhere",
      "variants": [
        {
          "content": "<img src=\"https://tpc.googlesyndication.com/archive/simgad/14075255850026292628\" height=\"173\" width=\"380\">",
          "height": 173,
          "width": 380
        }
      ],
      "start": "2025-02-04",
      "last_seen": "2025-03-06",
      "advertiser_name": "LeadMagic Inc",
      "format": "Text"
    }
  ],
  "credits_consumed": 8
}

​
Google Ads

Search for Google Ads run by a company. Analyze competitor advertising strategies, messaging, and creative approaches.

​
Endpoint Details

MetricValue
Cost0.2 credits per search
Calculation5 searches = 1 credit
No ResultsFREE if no ads found
Very cost-effective for competitive ad intelligence at just 0.2 credits per search.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v1/ads/google-ads-search' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"company_domain": "hubspot.com"}'

​
Request Parameters

​
company_domain
string
Company website domain (preferred).
​
company_name
string
Company name.
You must provide either company_domain or company_name (or both).

​
Response

​
company_name
string
required
Company searched
​
ads
array
required
Array of ad creatives
​
credits_consumed
number
required
Credits used (0.2 if found, 0 if not)
​
message
string
required
Human-readable status message

​
Ad Object

FieldTypeDescription
headlinestringAd headline
descriptionstringAd description
display_urlstringDisplay URL
final_urlstringLanding page URL
ad_typestringType of ad (text, responsive, etc.)

​
Example Response

{
  "company_name": "HubSpot",
  "ads": [
    {
      "headline": "Free CRM Software | HubSpot",
      "description": "Get started with free CRM. No credit card required.",
      "display_url": "hubspot.com/free-crm",
      "final_url": "https://hubspot.com/products/crm",
      "ad_type": "responsive_search"
    }
  ],
  "credits_consumed": 0.2,
  "message": "Ads found."
}

​
Success Messages

MessageMeaningCost
Ads found.Google Ads data returned0.2 credits
No ads found for this company.No Google Ads foundFREE

​
Best Practices

Study headlines and descriptions to understand positioning and value props.
Use final_urls to analyze competitor landing pages.
Regular monitoring reveals A/B tests and strategy shifts.

​
Use Cases

Competitive Intelligence

Understand competitor ad strategies and messaging.

Ad Copy Inspiration

Find proven messaging patterns in your market.

Market Research

Analyze advertising trends in your industry.

Landing Page Analysis

Discover competitor landing pages and offers.

Authorizations

​
X-API-Key
string
header
required

Your LeadMagic API key. Header name is case-insensitive (X-API-Key, X-API-KEY, x-api-key all work).

Body

application/json
​
company_domain
string
default:leadmagic.io

Company domain name

Example:

"leadmagic.io"

​
company_name
string
default:leadmagic

Company name

Example:

"leadmagic"

Response

Successful response with ads details

​
message
string
Example:

"Google Ads retrieved successfully"

​
credits_consumed
number
Example:

0.2

​
ads_count
integer
Example:

2

​
ads
object[]