Kadam icon

Kadam

Interact with Kadam API (v1.4.x) for managing campaigns, clients, creatives, and more.

Creative → Get

AI-generated

Overview

This node interacts with the Kadam advertising platform API to manage and retrieve data related to advertising creatives. Specifically, the Creative - Get operation allows users to fetch a list of ad creatives filtered by various criteria such as campaign IDs, ad format, or specific creative IDs.

Typical use cases include:

  • Retrieving all creatives for a given ad format to analyze or report on active ads.
  • Filtering creatives by campaign to monitor performance or update assets.
  • Selecting specific creatives by their IDs for detailed inspection or further processing.

For example, a marketing analyst might use this node to pull all creatives associated with certain campaigns to evaluate which ads are performing best or to prepare data for a dashboard.

Properties

Name Meaning
Campaign IDs List of campaign IDs to filter creatives by. Use the "Get Campaigns" operation to obtain valid IDs.
Ad Format Required. The ad format ID (e.g., 10 for Teaser). Use "Get Ad Formats" to retrieve available options.
Creative IDs Optional. Select specific creatives to retrieve by their IDs. Leave empty to get all creatives.
Retry on Failure Boolean flag to retry the request up to 3 times on temporary failures like rate limits or network issues.
Return All Boolean flag to return all results by automatically paginating through the data, ignoring limit/offset.
Limit Maximum number of items to return per request if "Return All" is false. Defaults to 100.
Offset Number of items to skip before starting to return results if "Return All" is false. Defaults to 0.

Output

The output is an array of JSON objects representing the retrieved creatives. Each object contains fields describing a creative, such as its ID, title, text description, target URL, media references, status, and targeting bids by country.

If multiple creatives are returned, each will be a separate item in the output array, paired with the input item index.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Kadam API.
  • The node makes HTTP requests to https://api.kadam.net endpoints.
  • The user must have appropriate permissions and valid credentials configured in n8n to access Kadam's API.
  • Some properties load options dynamically from the API (e.g., campaign IDs, ad formats, creatives), so internet connectivity and valid credentials are necessary.

Troubleshooting

  • Common Issues:

    • Invalid or expired API token causing authentication errors.
    • Specifying campaign or creative IDs that do not exist or belong to another account.
    • Network issues or rate limiting by the Kadam API.
  • Error Messages:

    • Errors from the API are wrapped and returned with details including HTTP status code and error description.
    • If the node encounters unexpected response formats, it logs warnings and attempts to wrap the data safely.
    • On failure, if "Retry on Failure" is enabled, the node retries up to 3 times before throwing an error.
    • To resolve authentication errors, verify and update the API key credential.
    • For invalid IDs, use the "Get Campaigns" or "Get Creatives" operations to confirm valid values.

Links and References

  • Kadam API Documentation (official API base URL used by the node)
  • Kadam API endpoints referenced:
    • /ads.materials.get — for fetching creatives
    • /ads.campaigns.get — for fetching campaigns (used in loading options)
    • /ads.campaigns.formats.get — for fetching ad formats (used in loading options)

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion