API

API PERENDER is a structured service that functions as an intermediary, allowing your requests to be executed in our business logic.

Initially, it enables caching and rendering of your page requests upon the first execution, regardless of the origin, returning the rendered view once the process is completed.
If your page request is already cached, it simply returns the previously cached view.

Authentication

To make requests to the API, it is necessary to send the PERENDER TOKEN in all cases. You can obtain the PERENDER TOKEN from the dashboard. crawl requests 0

PERENDER TOKEN is a JWT (JSON Web Token) that defines a compact and self-contained way of representing information between two parties in a secure manner as a JSON object. This token can be verified and trusted as it is digitally signed.

You can regenerate a new token at any time. Your token should not be exposed in your applications as any malicious user can impersonate your identity if acquired.

In the event of any possible security leak it must be regenerated.

We recommend using it in the most protected way possible.

Requests

All requests are made to the address: https://api.perender.com/render.

Parameters received in the query:

url (string): Address to render, cache, or retrieve as needed.

Example: https://example.com
botAgent (string): Bot identified in the request.

Example: integration-test

Example

To test the example, open a command prompt and paste the provided code. Don't forget to replace @("[PERENDER_TOKEN]") with your token from the dashboard.

Shell

curl -X GET "https://api.perender.com/render?url=https%3A%2F%2Fexample.com&botAgent=integration-test" -H "accept: */*" -H "Authorization: Bearer [PERENDER_TOKEN]"