SacNews - Encurtador de URL icon

SacNews - Encurtador de URL

Interage com a API de Encurtador de URLs

Overview

This node integrates with a URL shortening service API, allowing users to manage and retrieve information about shortened URLs. The "Listar URLs" (List URLs) operation fetches a list of shortened URLs from the service, supporting pagination, result limits, sorting, and filtering by a specific shortened URL.

Common scenarios for this node include:

  • Retrieving a paginated list of all shortened URLs created in an account.
  • Filtering to find details about a particular shortened URL.
  • Sorting URLs by creation date or number of clicks to analyze link performance.

Practical example:

  • A marketing team wants to get the top 50 most recently created shortened URLs to review their campaigns.
  • A user needs to find click statistics for a specific shortened URL by providing its short form.

Properties

Name Meaning
Número Da Página The page number of results to fetch (pagination).
Limite De Resultados Maximum number of results to return per request.
Ordenar Por How to sort the results; options are "Data" (by date) or "Cliques" (by number of clicks).
URL Encurtada Specific shortened URL to search for; if provided, other parameters are ignored and only this URL is fetched.

Output

The node outputs JSON data containing the list of shortened URLs matching the query parameters. Each item in the output typically includes details such as the original URL, the shortened URL, creation date, click statistics, and possibly campaign-related metadata.

If a specific shortened URL is requested, the output will contain details for that single URL.

No binary data output is indicated.

Dependencies

  • Requires connection to the URL shortening service API.
  • Needs an API authentication token or key configured in n8n credentials to authorize requests.
  • No additional external dependencies beyond the API and standard HTTP communication.

Troubleshooting

  • Empty results: If no URLs are returned, verify the page number and limit parameters, and ensure the account has URLs created.
  • Invalid API credentials: Authentication errors may occur if the API key/token is missing or incorrect; reconfigure credentials.
  • Rate limiting: The API might limit the number of requests; handle errors indicating too many requests by adding delays or retries.
  • Incorrect URL filter: When specifying a shortened URL, ensure it matches exactly the format expected by the API.

Links and References

  • Refer to the URL shortening service's official API documentation for detailed parameter descriptions and response formats.
  • n8n documentation on creating and using API credential types for secure authentication.

Discussion