Actions56
- Health Actions
- Project Actions
- Score Actions
- Characters Actions
- Environments Actions
- Scenes Actions
- Visuals Actions
- Visual Voiceover Actions
- Visual Image Actions
- Visual Video Actions
- Visual Sound Actions
- Video Actions
Overview
This node integrates with the AdBlast API to retrieve a list of all characters associated with a specified project. It is useful in scenarios where you need to programmatically access character data for projects managed within AdBlast, such as for automation workflows that involve content generation, character management, or syncing character information with other systems.
For example, you might use this node to:
- Fetch all characters from a project to display them in a dashboard.
- Automate updates or audits of character data by retrieving the full list regularly.
- Integrate character data into marketing or storytelling pipelines.
Properties
| Name | Meaning |
|---|---|
| Authentication Method | Choose how to authenticate: "Predefined Credentials" (use saved API credentials) or "Dynamic API Key" (enter key dynamically via expressions). |
| AdBlast Base URL | The base URL of the AdBlast API endpoint. Required only if using dynamic API key authentication. Default is https://dev.adblast.ai. |
| API Key | The API key used for authentication when using dynamic API key method. Can be set via expressions. |
| Project Id | The unique identifier of the project whose characters you want to retrieve. |
Output
The node outputs JSON data containing an array of character objects retrieved from the specified project. Each item in the output corresponds to a character with its associated properties as defined by the AdBlast API.
The output does not include binary data; it is purely JSON structured data representing characters.
Dependencies
- Requires access to the AdBlast API.
- Requires either saved API credentials or a dynamically provided API key.
- If using dynamic API key authentication, the user must provide the correct base URL and API key.
- The node expects the project ID to be valid and accessible with the provided credentials.
Troubleshooting
- Authentication errors: Ensure the API key is valid and has permissions to access the project. Check if the correct authentication method is selected and credentials are properly configured.
- Invalid Project Id: Verify that the project ID exists and is correctly typed.
- Network issues: Confirm that the base URL is reachable and there are no firewall or connectivity problems.
- Empty results: If no characters are returned, check if the project actually contains characters or if filters/permissions restrict access.
Links and References
- AdBlast API Documentation (assumed based on default URL)
- n8n documentation on API integrations for general guidance on API nodes