# Monitor a competitor's new LinkedIn ads weekly

**Use case:** 

Only ads you have not seen before: ads an earlier run delivered are not returned and not charged, and a run that finds nothing new costs nothing. The first runs work through the company's ads maxAds at a time; after that each run returns only new ads. The memory is named after the companies you watch. Save, then Schedule it and add Slack or Gmail from its Integrations tab.

## Input

```json
{
  "companies": [
    "https://www.linkedin.com/company/hubspot"
  ],
  "keywords": [],
  "payers": [],
  "startUrls": [],
  "adIds": [],
  "searches": [],
  "resultType": "ads",
  "countries": [],
  "dateRange": "any",
  "targetingIncludes": [],
  "targetingExcludes": [],
  "sortOrder": "newest",
  "includeRelatedAdvertisers": false,
  "adFormats": [],
  "minDaysRunning": 0,
  "onlyActive": false,
  "includeDetails": true,
  "includeCompanyInfo": false,
  "tagAds": false,
  "analyzeAds": false,
  "ocrImageAds": false,
  "transcribeVideos": false,
  "summaryRows": false,
  "outputFormat": "full",
  "maxAds": 300,
  "maxAdsPerSearch": 0,
  "onlyNewAds": true,
  "includeEndedAds": false
}
```

## Output

```json
{
  "row_type": {
    "label": "Row type",
    "format": "string"
  },
  "creative_id": {
    "label": "Ad id",
    "format": "string"
  },
  "ad_url": {
    "label": "Ad URL",
    "format": "string"
  },
  "ad_format": {
    "label": "Ad format",
    "format": "string"
  },
  "creative_type": {
    "label": "Creative type",
    "format": "string"
  },
  "format_label": {
    "label": "Format label",
    "format": "string"
  },
  "advertiser_name": {
    "label": "Advertiser name",
    "format": "string"
  },
  "advertiser_id": {
    "label": "Advertiser id",
    "format": "string"
  },
  "advertiser_slug": {
    "label": "Advertiser slug",
    "format": "string"
  },
  "advertiser_type": {
    "label": "Advertiser type",
    "format": "string"
  },
  "advertiser_url": {
    "label": "Advertiser URL",
    "format": "string"
  },
  "advertiser_logo_url": {
    "label": "Advertiser logo",
    "format": "string"
  },
  "member_name": {
    "label": "Member name",
    "format": "string"
  },
  "member_headline": {
    "label": "Member headline",
    "format": "string"
  },
  "member_url": {
    "label": "Member URL",
    "format": "string"
  },
  "payer": {
    "label": "Payer",
    "format": "string"
  },
  "headline": {
    "label": "Headline",
    "format": "string"
  },
  "headline_description": {
    "label": "Headline description",
    "format": "string"
  },
  "body_text": {
    "label": "Body text",
    "format": "string"
  },
  "body_text_preview": {
    "label": "Body text preview",
    "format": "string"
  },
  "body_text_truncated": {
    "label": "Body text truncated",
    "format": "boolean"
  },
  "cta": {
    "label": "CTA",
    "format": "string"
  },
  "cta_buttons": {
    "label": "Cta buttons",
    "format": "array"
  },
  "cta_type": {
    "label": "CTA type",
    "format": "string"
  },
  "destination_url": {
    "label": "Destination URL",
    "format": "string"
  },
  "landing_domain": {
    "label": "Landing domain",
    "format": "string"
  },
  "links_in_text": {
    "label": "Links in text",
    "format": "array"
  },
  "image_url": {
    "label": "Image",
    "format": "string"
  },
  "image_urls": {
    "label": "Images",
    "format": "array"
  },
  "video_url": {
    "label": "Video URL",
    "format": "string"
  },
  "video_urls": {
    "label": "Video renditions",
    "format": "array"
  },
  "video_preview_url": {
    "label": "Video poster",
    "format": "string"
  },
  "document_title": {
    "label": "Document title",
    "format": "string"
  },
  "document_url": {
    "label": "Document URL",
    "format": "string"
  },
  "document_cover_url": {
    "label": "Document cover",
    "format": "string"
  },
  "document_pages": {
    "label": "Document pages",
    "format": "integer"
  },
  "cards": {
    "label": "Cards",
    "format": "array"
  },
  "event_name": {
    "label": "Event name",
    "format": "string"
  },
  "event_time": {
    "label": "Event time",
    "format": "string"
  },
  "event_location": {
    "label": "Event location",
    "format": "string"
  },
  "message_sender_name": {
    "label": "Message sender name",
    "format": "string"
  },
  "message_sender_image_url": {
    "label": "Message sender photo",
    "format": "string"
  },
  "employer_brand_line": {
    "label": "Employer brand line",
    "format": "string"
  },
  "variants_count": {
    "label": "Variants count",
    "format": "integer"
  },
  "variants": {
    "label": "Variants",
    "format": "array"
  },
  "run_dates_text": {
    "label": "Run dates text",
    "format": "string"
  },
  "first_shown": {
    "label": "First shown",
    "format": "string"
  },
  "last_shown": {
    "label": "Last shown",
    "format": "string"
  },
  "days_shown": {
    "label": "Days shown",
    "format": "integer"
  },
  "is_active": {
    "label": "Is active",
    "format": "boolean"
  },
  "launched_last_7_days": {
    "label": "Launched in the last 7 days",
    "format": "boolean"
  },
  "launched_last_30_days": {
    "label": "Launched in the last 30 days",
    "format": "boolean"
  },
  "long_running": {
    "label": "Long running",
    "format": "boolean"
  },
  "has_eu_transparency": {
    "label": "Has EU transparency data",
    "format": "boolean"
  },
  "impressions_bucket": {
    "label": "Impressions bucket",
    "format": "string"
  },
  "impressions_min": {
    "label": "Impressions min",
    "format": "integer"
  },
  "impressions_max": {
    "label": "Impressions max",
    "format": "integer"
  },
  "impressions_by_country": {
    "label": "Impressions by country",
    "format": "array"
  },
  "top_country": {
    "label": "Top country",
    "format": "string"
  },
  "countries_count": {
    "label": "Countries count",
    "format": "integer"
  },
  "regions": {
    "label": "Regions",
    "format": "array"
  },
  "targeting_language": {
    "label": "Targeting language",
    "format": "array"
  },
  "targeting_language_excluded": {
    "label": "Targeting language excluded",
    "format": "array"
  },
  "targeting_locations": {
    "label": "Targeting locations",
    "format": "array"
  },
  "targeting_locations_excluded": {
    "label": "Targeting locations excluded",
    "format": "array"
  },
  "targeting_parameters": {
    "label": "Targeting parameters",
    "format": "object"
  },
  "targeting_other": {
    "label": "Targeting other",
    "format": "array"
  },
  "copy_length": {
    "label": "Copy length",
    "format": "integer"
  },
  "text_language": {
    "label": "Text language",
    "format": "string"
  },
  "sentiment_score": {
    "label": "Sentiment score",
    "format": "number"
  },
  "analysis_angle": {
    "label": "Analysis angle",
    "format": "string"
  },
  "analysis_cta_intent": {
    "label": "Analysis CTA intent",
    "format": "string"
  },
  "analysis_tone": {
    "label": "Analysis tone",
    "format": "string"
  },
  "analysis_sentiment": {
    "label": "Analysis sentiment",
    "format": "number"
  },
  "analysis_offer_type": {
    "label": "Analysis offer type",
    "format": "string"
  },
  "analysis_funnel_stage": {
    "label": "Analysis funnel stage",
    "format": "string"
  },
  "analysis_target_function": {
    "label": "Analysis target function",
    "format": "string"
  },
  "analysis_confidence": {
    "label": "Analysis confidence",
    "format": "object"
  },
  "analysis_hook": {
    "label": "Analysis hook",
    "format": "string"
  },
  "analysis_offer": {
    "label": "Analysis offer",
    "format": "string"
  },
  "analysis_audience": {
    "label": "Analysis audience",
    "format": "string"
  },
  "analysis_strategy": {
    "label": "Analysis strategy",
    "format": "string"
  },
  "ad_ocr_text": {
    "label": "Image text",
    "format": "string"
  },
  "transcript": {
    "label": "Transcript",
    "format": "string"
  },
  "transcript_language": {
    "label": "Transcript language",
    "format": "string"
  },
  "hook_3s": {
    "label": "Hook (first 3 s)",
    "format": "string"
  },
  "speech_seconds": {
    "label": "Speech seconds",
    "format": "number"
  },
  "video_duration_s": {
    "label": "Video duration s",
    "format": "number"
  },
  "transcript_segments": {
    "label": "Transcript segments",
    "format": "array"
  },
  "advertiser_industry": {
    "label": "Advertiser industry",
    "format": "string"
  },
  "advertiser_size": {
    "label": "Advertiser size",
    "format": "string"
  },
  "advertiser_employees_min": {
    "label": "Advertiser employees min",
    "format": "integer"
  },
  "advertiser_employees_max": {
    "label": "Advertiser employees max",
    "format": "integer"
  },
  "advertiser_employees_on_linkedin": {
    "label": "Advertiser employees on linkedin",
    "format": "integer"
  },
  "advertiser_tagline": {
    "label": "Advertiser tagline",
    "format": "string"
  },
  "advertiser_similar_pages": {
    "label": "Advertiser similar pages",
    "format": "array"
  },
  "advertiser_headquarters": {
    "label": "Advertiser headquarters",
    "format": "string"
  },
  "advertiser_founded": {
    "label": "Advertiser founded",
    "format": "integer"
  },
  "advertiser_company_type": {
    "label": "Advertiser company type",
    "format": "string"
  },
  "advertiser_website": {
    "label": "Advertiser website",
    "format": "string"
  },
  "advertiser_followers": {
    "label": "Advertiser followers",
    "format": "integer"
  },
  "advertiser_specialties": {
    "label": "Advertiser specialties",
    "format": "array"
  },
  "detail_status": {
    "label": "Detail status",
    "format": "string"
  },
  "matched_query": {
    "label": "Matched query",
    "format": "string"
  },
  "matched_queries": {
    "label": "Matched queries",
    "format": "array"
  },
  "claimed_count": {
    "label": "Claimed count",
    "format": "integer"
  },
  "first_seen_at": {
    "label": "First seen",
    "format": "string"
  },
  "last_seen_at": {
    "label": "Last seen at",
    "format": "string"
  },
  "ended_at": {
    "label": "Ended at",
    "format": "string"
  },
  "scraped_at": {
    "label": "Scraped at",
    "format": "string"
  },
  "run_tag": {
    "label": "Run tag",
    "format": "string"
  },
  "has_ads": {
    "label": "Has ads",
    "format": "boolean"
  },
  "search_query": {
    "label": "Search query",
    "format": "string"
  },
  "advertiser_description": {
    "label": "Advertiser description",
    "format": "string"
  },
  "summary_ad_count": {
    "label": "Summary ad count",
    "format": "integer"
  },
  "summary_active_count": {
    "label": "Summary active count",
    "format": "integer"
  },
  "summary_longest_days": {
    "label": "Summary longest days",
    "format": "integer"
  },
  "summary_formats": {
    "label": "Summary formats",
    "format": "array"
  },
  "summary_landing_domains": {
    "label": "Summary landing domains",
    "format": "array"
  },
  "summary_countries": {
    "label": "Summary countries",
    "format": "array"
  },
  "summary_distinct_copies": {
    "label": "Summary distinct copies",
    "format": "integer"
  },
  "summary_ad_ids": {
    "label": "Summary ad ids",
    "format": "array"
  },
  "display_url": {
    "label": "Display url",
    "format": "string"
  }
}
```

## About this Actor

This example demonstrates how to use [LinkedIn Ad Library Scraper — Competitor LinkedIn Ads Library](https://apify.com/hyperbach/linkedin-ad-library-scraper.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/hyperbach/linkedin-ad-library-scraper.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

This Task's input is already configured above. Use it as-is rather than inventing a new one.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/hyperbach/linkedin-ad-library-scraper.md

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).