Kiwify icon

Kiwify

Interagir com a API da Kiwify

Overview

This node integrates with the Kiwify API to perform various operations related to managing products, sales, affiliates, webhooks, payouts, and account details. Specifically, the "Listar Produtos" (List Products) operation retrieves a paginated list of products from the Kiwify platform.

Typical use cases include:

  • Fetching product lists for inventory synchronization.
  • Displaying available products in external dashboards or applications.
  • Automating workflows that depend on product data updates.

For example, you might use this node to retrieve 10 products per page and process them in batches for reporting or integration with other systems.

Properties

Name Meaning
Tamanho Da Página Number of products to return per page (e.g., 10)
Número Da Página Page number to retrieve (e.g., 1 for first page)

These properties control pagination when listing products, allowing users to specify how many products to fetch and which page of results to retrieve.

Output

The node outputs an array of JSON objects representing the products retrieved from the Kiwify API. Each item corresponds to a product with its associated details as returned by the API.

The output structure is directly based on the API response for the products endpoint and typically includes fields such as product ID, name, description, price, and other relevant metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Kiwify API.
  • The node uses OAuth token retrieval internally by exchanging client credentials.
  • Requires configuration of the API key credential with clientId, clientSecret, and accountId.
  • Network access to https://public-api.kiwify.com is necessary.

Troubleshooting

  • Authentication errors: If the node fails to authenticate, verify that the API key credential is correctly configured with valid client ID, client secret, and account ID.
  • Pagination issues: Requesting a page number beyond the available range may return empty results. Adjust Número Da Página accordingly.
  • API rate limits: Excessive requests may be throttled by the Kiwify API. Implement delays or retries if needed.
  • Network errors: Ensure the n8n instance has internet access and can reach the Kiwify API endpoint.

Common error messages will include HTTP status codes and messages from the Kiwify API, such as unauthorized access or invalid parameters. Review these messages to adjust credentials or input parameters.

Links and References

Discussion