Company Ads

Retrieve company ads from Google Ad Library with a single API request.

GET/api/data/v1/google/company/ads

1credit base cost

With get_ad_details=true, this request can use up to 25 credits. The exact charge is returned with the response.

Request parameters

Up to 1 credit

domainoptional

The domain of the company

advertiser_idoptional

The advertiser id of the company

topicoptional

The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU'

regionoptional

The region to search for. Defaults to anywhere

start_dateoptional

Start date to search for. Format: YYYY-MM-DD

end_dateoptional

End date to search for. Format: YYYY-MM-DD

platformoptional

Platform to search for.

formatoptional

Ad format to search for.

get_ad_detailsoptional

Set to true to get the ad details. Will cost 25 credits.

cursoroptional

Cursor to paginate through results

Try in the console

Live requests use your prepaid balance. Cached responses cost zero where supported.

curl --request GET \
  --url 'https://fetchgoblin.com/api/data/v1/google/company/ads' \
  --header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'

Response

Example

{
  "success": true,
  "ads": [
    {
      "advertiserId": "AR01614014350098432001",
      "creativeId": "CR08567627846124568577",
      "format": "image",
      "adUrl": "https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR08567627846124568577",
      "advertiserName": "lululemon athletica canada inc.",
      "imageUrl": null,
      "firstShown": "2026-03-11T17:08:22.000Z",
      "lastShown": "2026-05-04T17:59:12.000Z"
    }
  ],
  "cursor": "CgoAP7zmu%2FzKj6ijEhBBAgiPtk1y16J9lpkAAAAAGgn8%2BHbW%2BJylE6g%3D",
  "number_of_ads_estimate": 20000,
  "credits_charged": 1,
  "credits_remaining": 1000,
  "request_id": "00000000-0000-4000-8000-000000000000"
}

Example data from the API specification. Run a request to retrieve current data.

Response shape

This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.

View JSON Schema +

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "ads": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "advertiserId": {
            "type": "string"
          },
          "creativeId": {
            "type": "string"
          },
          "format": {
            "type": "string"
          },
          "adUrl": {
            "type": "string"
          },
          "advertiserName": {
            "type": "string"
          },
          "imageUrl": {
            "type": [
              "string",
              "object",
              "array",
              "number",
              "boolean",
              "null"
            ]
          },
          "firstShown": {
            "type": "string"
          },
          "lastShown": {
            "type": "string"
          }
        }
      }
    },
    "cursor": {
      "type": "string"
    },
    "number_of_ads_estimate": {
      "type": "integer"
    },
    "credits_charged": {
      "type": "integer",
      "minimum": 0,
      "description": "FetchGoblin credits charged for this request."
    },
    "credits_remaining": {
      "type": "integer",
      "description": "Your FetchGoblin credit balance after this request."
    },
    "request_id": {
      "type": "string",
      "format": "uuid",
      "description": "FetchGoblin request identifier."
    }
  }
}

More Google Ad Library endpoints Errors and credit accounting