Scrape Creators icon

Scrape Creators

Get real time social media data

Overview

The "LinkedIn Ad Library - Search Ads" operation allows users to search for LinkedIn advertisements based on keywords, companies, countries, and date ranges. This node is useful for marketers, researchers, or analysts who want to gather insights about LinkedIn ad campaigns, monitor competitors, or analyze advertising trends on LinkedIn.

Practical examples include:

  • Searching for ads related to a specific keyword like "web scraping" to understand how companies promote such services.
  • Filtering ads by company name (e.g., "Google") to see their active LinkedIn ad campaigns.
  • Restricting searches to certain countries or date ranges to analyze regional or temporal ad performance.

Properties

Name Meaning
Keyword The keyword to search for in LinkedIn ads. Can be a company name or any relevant term.
Additional Fields A collection of optional filters:
- Company Filter ads by a specific company name.
- Countries Comma-separated list of 2-letter country codes to limit the search geographically (e.g., US,CA).
- Start Date The start date (YYYY-MM-DD) to filter ads from this date onwards.
- End Date The end date (YYYY-MM-DD) to filter ads up to this date.
Limit Maximum number of ad results to return.

Output

The node outputs JSON data containing the search results of LinkedIn ads matching the specified criteria. Each item in the output typically represents an individual ad with details such as ad content, company, targeting info, dates, and other metadata provided by the LinkedIn Ad Library API.

If binary data is returned (not indicated here), it would represent media assets related to ads, but this node primarily focuses on JSON structured ad information.

Dependencies

  • Requires an API key credential for accessing the Scrape Creators API service.
  • The node sends requests to https://api.scrapecreators.com with appropriate headers including the API key.
  • No additional environment variables are explicitly required beyond the API key credential.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication errors.
    • Incorrect date formats for start/end dates may result in request failures.
    • Exceeding the limit parameter or requesting too many results might lead to rate limiting or partial responses.
    • Providing invalid country codes could cause empty or error responses.
  • Error messages:

    • Authentication errors: Check that the API key credential is correctly configured.
    • Validation errors: Ensure all input fields, especially dates and country codes, follow the expected format.
    • Network or timeout errors: Verify network connectivity and API service status.

Links and References

Discussion