Skip to main content
POST
/
v1
/
ads
/
b2b-ads-details
B2B Ad Details
curl --request POST \
  --url https://api.leadmagic.io/v1/ads/b2b-ads-details \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "ad_url": 633872143
}
'
{
  "message": "Ad details retrieved successfully",
  "credits_consumed": 2,
  "ad_details": {
    "ads_type": "Video Ad",
    "content": "Start your day knowing what deals you need to focus on instead of opening up a dozen tabs in your CRM.",
    "image": null,
    "heading": "Discover how our platform drives better sales outcomes",
    "sub_heading": null,
    "availability_duration": null,
    "cta": {
      "button_text": "Learn more",
      "link": "https://leadmagic.io/why-leadmagic/?trk=ad_library_ad_preview_headline_content"
    },
    "video": {
      "video_thumbnail": "https://media.licdn.com/dms/image/v2/D4D10AQGzuzrGo4HoHw/videocover-high/videocover-high/0/1729725542194/InstantDemoStartofDaymp4?e=2147483647&v=beta&t=mu3nEXijLeoh_jU49uhAGqgEWlVrH5j7oT4B4UBgezk",
      "data_sources": [
        {
          "type": "video/mp4",
          "src": "https://dms.licdn.com/playlist/vid/v2/D4D10AQGzuzrGo4HoHw/progressive-servable-video/progressive-servable-video/0/1729725541436/InstantDemoStartofDaymp4?e=2147483647&v=beta&t=OIP5SAQ2zRwNyY97Sgh0RRDUZqZvFYW0MUDHP5F8Q54",
          "bitrate": 6284199
        },
        {
          "type": "video/mp4",
          "src": "https://dms.licdn.com/playlist/vid/v2/D4D10AQGzuzrGo4HoHw/mp4-640p-30fp-crf28/mp4-640p-30fp-crf28/0/1729725548053/InstantDemoStartofDaymp4?e=2147483647&v=beta&t=9cV-2R6MxcHoetYcg1Wuos9Wyi73haSAIgzlFFe4Izc",
          "bitrate": 245220
        },
        {
          "type": "video/mp4",
          "src": "https://dms.licdn.com/playlist/vid/v2/D4D10AQGzuzrGo4HoHw/mp4-360p-30fp-crf28/mp4-360p-30fp-crf28/0/1729725547788/InstantDemoStartofDaymp4?e=2147483647&v=beta&t=xSM4xV1YorfPdlNWuSYqg9nacRTLE0F_DkLzdK9mgdQ",
          "bitrate": 109857
        },
        {
          "type": "video/mp4",
          "src": "https://dms.licdn.com/playlist/vid/v2/D4D10AQGzuzrGo4HoHw/mp4-720p-30fp-crf28/mp4-720p-30fp-crf28/0/1729725549253/InstantDemoStartofDaymp4?e=2147483647&v=beta&t=f_bLk9pQQU8O5XoBapMPtqz-bZD6RQqTVLYkrYSAnlU",
          "bitrate": 316022
        }
      ]
    },
    "total_impressions": null,
    "country_impressions": [],
    "targeting_language": null,
    "targeting_location": null,
    "organization": {
      "b2b_profile": 10454372,
      "advertiser": "LeadMagic"
    },
    "about_ad_paying_entity": "Paid for by LeadMagic Inc."
  }
}

​
B2B Ad Details

Get detailed information about a specific B2B professional network advertisement. Includes full creative content, video data, targeting, and performance metrics.

​
Endpoint Details

MetricValue
Cost2 credits per ad
No ResultsFREE if ad not found
Use the ad ID from B2B Ads Search to get complete details.

​
Quick Example

curl -X POST 'https://api.leadmagic.io/v1/ads/b2b-ads-details' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"ad_url": "https://www.linkedin.com/ad-library/detail/633872143"}'

​
Request Parameters

​
ad_url
string
required
The Ad Library URL or ID (from B2B Ads Search).
Get the ad_url from the link field in B2B Ads Search results.

​
Response

​
ad_id
string
required
Ad identifier
​
headline
string
Ad headline
​
content
string
Full ad copy
​
advertiser
object
Advertiser company info (name, profile URL)
​
creative
object
Creative assets (images, videos)
​
targeting
object
Targeting criteria (if available)
​
started_running
string
When ad started
​
impressions
object
Impression range (if available)
​
credits_consumed
number
required
Credits used (2 if found, 0 if not)

​
Example Response

{
  "ad_id": "633872143",
  "headline": "Transform your sales with AI",
  "content": "Our platform helps sales teams close more deals with AI-powered insights...",
  "advertiser": {
    "name": "LeadMagic",
    "profile_url": "linkedin.com/company/leadmagichq"
  },
  "creative": {
    "image_url": "https://...",
    "video_url": null,
    "format": "single_image"
  },
  "targeting": {
    "locations": ["United States", "Canada"],
    "industries": ["Technology", "Finance"]
  },
  "started_running": "2026-01-15",
  "impressions": {
    "min": 10000,
    "max": 50000
  },
  "credits_consumed": 2,
  "message": "Ad details found."
}

​
Success Messages

MessageMeaningCost
Ad details found.Full ad data returned2 credits
Ad not found.Ad doesn’t exist or expiredFREE

​
Workflow

1

Search for Ads

Use B2B Ads Search to find ads for a company.
2

Get Ad IDs

Extract the link field from search results.
3

Fetch Details

Use this endpoint to get full creative and targeting data.
4

Analyze

Study messaging, targeting, and creative approaches.

​
Best Practices

Only fetch details for the most relevant ads from search results.
Targeting data reveals which audiences competitors prioritize.
Video URLs allow you to analyze video ad creative in detail.

​
Use Cases

Creative Analysis

Study complete ad creative including video content.

Targeting Intelligence

Understand competitor audience targeting strategies.

Performance Benchmarks

Use impression data to benchmark ad performance.

Competitive Reports

Build detailed competitive advertising reports.

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
​
ad_url
string
default:633872143
required

The URL of the B2B advertisement from the ad library

Example:

633872143

Response

Successful response with ad details

​
message
string
Example:

"Ad details retrieved successfully"

​
credits_consumed
number
Example:

2

​
ad_details
object

Detailed information about the ad (structure varies by ad type)