---
title: "B2B Search Ads"
method: POST
path: "/v1/ads/b2b-ads-search"
tags: ["Ads Data"]
---

# B2B Search Ads

`POST /v1/ads/b2b-ads-search`

Search for B2B ads by company domain or name. Charged 1 base credit plus 1 credit per ad returned (minimum 1 credit).

## Request body

- object
  - `company_domain` string — Company domain name
  - `company_name` string — Company name
  - `limit` integer — Maximum number of ads to return. Because you are charged 1 credit per ad returned, this also caps the per-ad credits spent on the request; the 1 base credit per search still applies. Omit to return every ad found.

## Response `200`

Successful response with ads details

- object
  - `message` string
  - `credits_consumed` number
  - `ads_count` integer
  - `company` object
    - `name` string, nullable
    - `domain` string, nullable
    - `industry` string, nullable
    - `company_size` string, nullable
    - `linkedin_url` string, nullable — B2B company profile URL (/company/{slug})
    - `logo_url` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `country` string, nullable
  - `ads` object[]
    - `ad_id` string
    - `headline` string, nullable
    - `description` string, nullable
    - `content` string
    - `link` string
    - `ad_url` string
    - `image_url` string, nullable
    - `carousel_images` string[]
    - `ad_type` string, nullable
    - `creative_type` string, nullable
    - `advertiser` string, nullable
    - `advertiser_linkedin_url` string, nullable — Advertiser B2B company profile URL (/company/{slug})
    - `cta_text` string, nullable
    - `landing_page_url` string, nullable

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key
- `402` — Payment Required - Insufficient credits for this request. **Action required:** Add credits to your account at https://app.leadmagic.io/settings/billing
- `429` — Too Many Requests - Rate limit exceeded. **Action required:** Check the `Retry-After` header for when to retry. **Headers returned:** - `Retry-After`: Seconds until you can retry - `RateLimit-Limit`: Your limit per minute - `RateLimit-Remaining`: Remaining requests this minute - `RateLimit-Reset`: Seconds until limit resets
- `500` — Internal Server Error - Something went wrong on our end. **Action required:** Wait 30 seconds and retry. If the problem persists, contact support@leadmagic.io

---

[API](https://skmtc.net/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.net/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/revisions/aa19cf9bc46a/schema)