KadamInstall

Overview

This node interacts with the Kadam API to retrieve geo-targeted country data for advertising targeting purposes. Specifically, the "Get Geo Countries" operation fetches a list of countries that can be used for geographic targeting in ad campaigns.

Common scenarios where this node is beneficial include:

• Setting up or refining ad campaign targeting by selecting specific countries.
• Dynamically retrieving available geo-targeting options before creating or updating campaigns.
• Integrating geo-targeting data into automated workflows for campaign management.

For example, a user might use this node to get all geo-targeted countries and then filter or select countries to target ads based on performance metrics or business requirements.

Properties

Output

The output is a JSON array of objects representing geo-targeted countries. Each object contains fields describing a country, such as its ID, title (name), and ISO code. The exact fields included depend on the "Output Fields" property; if left empty, all available fields are returned.

No binary data is produced by this operation.

Example output JSON snippet:

[
  {
    "id": 1,
    "title": "United States",
    "iso": "US"
  },
  {
    "id": 2,
    "title": "Canada",
    "iso": "CA"
  }
]

Dependencies

• Requires an API key credential for authenticating with the Kadam API.
• The node makes HTTP requests to https://api.kadam.net endpoints.
• Proper configuration of the Kadam API credentials (API token and App ID) within n8n is necessary.

Troubleshooting

• Temporary Failures / Rate Limits: If the API returns errors due to rate limiting or transient network issues, enabling "Retry on Failure" can help by automatically retrying the request up to 3 times.
• Invalid Credentials: Errors related to authentication usually indicate missing or incorrect API tokens or App IDs. Verify that the credentials are correctly set up in n8n.
• Empty or Unexpected Response: If no countries are returned or the response format is unexpected, check the API status and ensure the account has access to geo-targeting data.
• Malformed Output Fields: Providing invalid field names in "Output Fields" may result in incomplete or empty responses. Use valid field names like id, title, and iso.

Links and References

• Kadam API Documentation (general reference for API endpoints)
• n8n documentation on Creating Custom Nodes
• Axios HTTP client (used internally for API requests): https://axios-http.com/