Products Grid

GET to list; POST to create/add/update (same endpoint, including empty grid); DELETE to remove. Official endpoint: api/products-grid (requires API key).

Retrieve all

GET https://lerline.com/api/products-grid

GET endpoint `api/products-grid`. Requires Authorization: Bearer {api_key}. Lists your block products. Response includes description_short, scrape_meta (reviews), discount_percent, cta_button_text (button label) and affiliate behaviour. status: active | out_of_stock | unavailable. Parameters: block_id (required), q (also searches description_short), category, page, results_per_page.

ParametersRequiredDescription
block_idRequiredID do bloco de grade de produtos.
qOptionalTermo de busca.
categoryOptionalFiltrar por categoria.
pageOptionalPágina (padrão 1).
results_per_pageOptionalItens 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": "",
      "description_short": "",
      "category": "",
      "link": "https://...",
      "canonical_link": "",
      "price": "0.00",
      "currency": "BRL",
      "discount_percent": null,
      "status": "active",
      "display_favicon": false,
      "open_in_new_tab": true,
      "cta_button_text": "Ver curso",
      "search_tags": "",
      "product_sku": "",
      "affiliate_link_set": false,
      "affiliate_unavailable_action": "warn",
      "affiliate_unavailable_redirect_url": "",
      "media_gallery": null,
      "scrape_meta": {
        "reviews": {
          "rating": 4.8,
          "rating_max": 5,
          "count": 1200,
          "summary": ""
        },
        "seller": {
          "name": "Loja exemplo"
        },
        "stock": {
          "label": "Disponível",
          "in_stock": true
        }
      },
      "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"
  }
}

Create / add / update (POST)

POST https://lerline.com/api/products-grid

POST creates products when the grid is empty (mode append). Also adds or updates (existing product_id). Body: block_id, products, mode. Optional: description_short, scrape_meta, discount_percent, cta_button_text (max 32; e.g. View course), affiliate_unavailable_action, status. Apify format accepted. Prefer api/products-grid (not legacy api/products).

CampoRequiredDescription
block_idRequiredID do bloco (deve ser seu).
productsRequiredArray de produtos (formato grade ou Apify).
products[0].product_idOptionalSe existir no bloco, actualiza; se a grade estiver vazia ou o ID for novo, cria.
products[0].description_shortOptionalDescrição curta do card.
products[0].scrape_metaOptionalAvaliações (reviews), vendedor, estoque, preço da loja.
products[0].discount_percentOptionalDesconto 1–99 (ou via scrape_meta.price.discount_percent).
products[0].cta_button_textOptionalTexto do botão neste item (máx. 32). Vazio = usa o padrão da grade / «Ver produto». Ex.: Ver curso, Descarregar.
products[0].affiliate_unavailable_actionOptionalwarn, hide ou redirect.
products[0].statusOptionalactive, out_of_stock ou unavailable.
modeOptionalappend (criar/adicionar; padrão) ou replace (substituir todos).
 
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://...", "cta_button_text": "Ver curso", "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

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.

ParametersRequiredDescription
block_idRequiredID do bloco de grade de produtos.
product_idOptionalID 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
  }
}