Actions59
- Facebook Actions
- Facebook Ad Library Actions
- Google Ad Library Actions
- Google Search Actions
- Instagram Actions
- LinkedIn Actions
- LinkedIn Ad Library Actions
- Pinterest Actions
- Reddit Actions
- Thread Actions
- TikTok Actions
- Truth Social Actions
- Twitter (X) Actions
- YouTube Actions
Overview
The "Facebook Ad Library" resource with the "Search Ads" operation allows users to search for Facebook advertisements based on a query string and various optional filters. This node is useful for marketers, researchers, or analysts who want to gather insights about active or inactive ads related to specific keywords, countries, ad types, or time frames. For example, a user could search for all political ads mentioning "climate change" in the US during 2023 to analyze campaign trends.
Properties
| Name | Meaning |
|---|---|
| Query | The search term or phrase to find relevant ads (e.g., "yoga pants"). |
| Additional Fields | Optional filters to refine the search: |
| - Ad Type | Filter by ad category: "All" or "Political and Issue Ads". |
| - Country | Two-letter country code to limit results geographically (e.g., "US", "CA", "MX"). |
| - End Date | Search ads ending before this date (format YYYY-MM-DD). |
| - Search Type | How the query is matched: "Keyword Unordered" or "Keyword Exact Phrase". |
| - Start Date | Search ads starting after this date (format YYYY-MM-DD). |
| - Status | Filter ads by status: "All", "Active", or "Inactive". |
| Limit | Maximum number of ads to return (e.g., 50). |
Output
The node outputs JSON data containing the list of ads matching the search criteria. Each item typically includes details such as ad content, type, status, dates, and possibly metadata like targeting or impressions. If binary data were involved (e.g., images), it would be summarized accordingly, but this node focuses on JSON ad data.
Dependencies
- Requires an API key credential for authentication with the Scrape Creators API service.
- The node sends requests to
https://api.scrapecreators.comwith appropriate headers including the API key. - No additional environment variables are explicitly required beyond the API key configuration.
Troubleshooting
- Common Issues:
- Invalid or missing API key will cause authentication failures.
- Incorrect date formats for start_date or end_date may result in errors or no results.
- Exceeding the allowed limit or rate limits imposed by the API can cause request failures.
- Error Messages:
- Authentication errors: Verify that the API key is correctly set up in credentials.
- Validation errors: Check that required fields like "Query" and "Limit" are provided and properly formatted.
- No results found: Try broadening the query or adjusting filters like date range or country.
Links and References
- Facebook Ad Library official documentation
- Scrape Creators API documentation (for API usage details)
- n8n Documentation (for general node usage and credential setup)