Products Grid
GET to list your block products (requires API key). POST to update or add products (requires API key).
GET https://lerline.com/api/products-grid
GET endpoint `api/products-grid`. Requires header Authorization: Bearer {api_key}. Lists products for the given block (you must own the block). Parameters: block_id (required), q (search), category, page, results_per_page.
| Parameters | Required | Description |
|---|---|---|
| block_id | Required | ID do bloco de grade de produtos. |
| q | Optional | Termo de busca. |
| category | Optional | Filtrar por categoria. |
| page | Optional | Página (padrão 1). |
| results_per_page | Optional | Itens por página: 10, 25, 50, 100, 250, 500 ou 1000 (padrão conforme a conta). |
curl --request GET \
--url 'https://lerline.com/api/products-grid?block_id=123' \
--header 'Authorization: Bearer {api_key}'
{
"data": [
{
"product_id": "prod_123_1700000000_123",
"biolink_block_id": 123,
"title": "Produto",
"description": "",
"category": "",
"link": "https://...",
"canonical_link": "",
"price": "0.00",
"currency": "",
"status": "visible",
"display_favicon": false,
"open_in_new_tab": true,
"search_tags": "",
"product_sku": "",
"affiliate_link_set": false,
"media_gallery": null,
"order": 0,
"datetime": "2026-01-01 12:00:00"
}
],
"meta": {
"page": 1,
"results_per_page": 25,
"total": 1,
"total_pages": 1
},
"links": {
"first": "https://lerline.com/api/products-grid?block_id=123&page=1",
"last": "https://lerline.com/api/products-grid?block_id=123&page=1",
"next": null,
"prev": null,
"self": "https://lerline.com/api/products-grid?block_id=123&page=1"
}
}
POST https://lerline.com/api/products-grid
Requires header Authorization: Bearer {api_key}. JSON body: block_id, products (array), mode (append or replace). Optional: products[].product_id — if it exists in the block, the product is updated instead of duplicated.
| Campo | Required | Description |
|---|---|---|
| block_id | Required | ID do bloco (deve ser seu). |
| products | Required | Array de produtos (formato grade ou Apify). |
| products[0].product_id | Optional | ID do produto dentro do array products. Se informado e existir no bloco, o produto é atualizado (em vez de inserir um novo). |
| mode | Optional | append (adicionar) ou replace (substituir todos). Padrão: append. |
curl --request POST \
--url 'https://lerline.com/api/products-grid' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{"block_id": 123, "products": [{"title": "Produto", "link": "https://...", "media_gallery": {"items": [{"type": "image", "url": "https://..."}]}}], "mode": "append"}'
curl --request POST \
--url 'https://lerline.com/api/products-grid' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{"block_id": 123, "products": [{"product_id":"prod_123_1700000000_123","title":"Produto (atualizado)","link":"https://...","media_gallery":{"items":[{"type":"image","url":"https://..."}]}}], "mode": "append"}'
{
"data": {
"imported": 1,
"skipped": 0,
"limit_reached": false
}
}
DELETE https://lerline.com/api/products-grid
DELETE endpoint `api/products-grid`. Requires header Authorization: Bearer {api_key}. Use block_id (required) + product_id (query) to delete a single product, or send JSON {"product_ids":[...]} to delete in bulk.
| Parameters | Required | Description |
|---|---|---|
| block_id | Required | ID do bloco de grade de produtos. |
| product_id | Optional | ID do produto a deletar (string retornada no GET como product_id). |
curl --request DELETE \
--url 'https://lerline.com/api/products-grid?block_id=123&product_id=prod_123_1700000000_123' \
--header 'Authorization: Bearer {api_key}'
curl --request DELETE \
--url 'https://lerline.com/api/products-grid?block_id=123' \
--header 'Authorization: Bearer {api_key}' \
--header 'Content-Type: application/json' \
--data '{"product_ids":["prod_123_1700000000_123","prod_123_1700000001_456"]}'
{
"data": {
"deleted": 2
}
}