> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ScrapeCreators: Google Company Ads

> Google: Fetches public company ads by domain or advertiser_id. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

Google: Fetches public company ads by domain or advertiser\_id.

> [!NOTE]
>
> Tool ID: `scrapecreators_google_company_ads`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'scrapecreators_google_company_ads',
  {
    "domain": "example.com",
    "advertiser_id": "advertiser_123",
    "topic": "all"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute scrapecreators_google_company_ads --input '{
  "domain": "example.com",
  "advertiser_id": "advertiser_123",
  "topic": "all"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe scrapecreators_google_company_ads --json` for the complete live contract.

## Input reference

Fetches public company ads by domain or advertiser\_id. firstShown can be null in /v1/google/ad for the same ad, so keep the list date rather than overwriting it with a null detail date. Login-only ads are unavailable.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.domain` | `string` | No | — | The domain of the company |
| `payload.advertiser_id` | `string` | No | — | The advertiser id of the company |
| `payload.topic` | `"all" \| "political"` | No | — | The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU' Allowed: `all`, `political`. |
| `payload.region` | `string` | No | — | The region to search for. Defaults to anywhere |
| `payload.start_date` | `string` | No | — | Start date to search for. Format: YYYY-MM-DD |
| `payload.end_date` | `string` | No | — | End date to search for. Format: YYYY-MM-DD |
| `payload.platform` | `"google_maps" \| "google_play" \| "google_search" \| "google_shopping" \| "youtube"` | No | — | Platform to search for. Allowed: `google_maps`, `google_play`, `google_search`, `google_shopping`, `youtube`. |
| `payload.format` | `"text" \| "image" \| "video"` | No | — | Ad format to search for. Allowed: `text`, `image`, `video`. |
| `payload.get_ad_details` | `string` | No | — | Set to true to get the ad details. |
| `payload.cursor` | `string` | No | — | Cursor to paginate through results |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Fetches public company ads by domain or advertiser_id. firstShown can be null in /v1/google/ad for the same ad, so keep the list date rather than overwriting it with a null detail date. Login-only ads are unavailable.",
    "properties": {
      "domain": {
        "type": "string",
        "description": "The domain of the company"
      },
      "advertiser_id": {
        "type": "string",
        "description": "The advertiser id of the company"
      },
      "topic": {
        "type": "string",
        "description": "The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU'",
        "enum": [
          "all",
          "political"
        ]
      },
      "region": {
        "type": "string",
        "description": "The region to search for. Defaults to anywhere"
      },
      "start_date": {
        "type": "string",
        "description": "Start date to search for. Format: YYYY-MM-DD"
      },
      "end_date": {
        "type": "string",
        "description": "End date to search for. Format: YYYY-MM-DD"
      },
      "platform": {
        "type": "string",
        "description": "Platform to search for.",
        "enum": [
          "google_maps",
          "google_play",
          "google_search",
          "google_shopping",
          "youtube"
        ]
      },
      "format": {
        "type": "string",
        "description": "Ad format to search for.",
        "enum": [
          "text",
          "image",
          "video"
        ]
      },
      "get_ad_details": {
        "type": "string",
        "description": "Set to true to get the ad details."
      },
      "cursor": {
        "type": "string",
        "description": "Cursor to paginate through results"
      }
    },
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `unknown` | Yes | — | Provider response payload. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "description": "Provider response payload."
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Deepline cost

* Pricing model: `provider_usage` (provider usage).
* Estimated Deepline credits: `0.02` per pricing unit.

## Related documentation

* [ScrapeCreators provider guide](https://deepline.com/docs/providers/scrapecreators/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.