> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domsoftware.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Anúncios

> Retorna uma listagem paginada de todos os anúncios (listings) já sincronizados das contas dos Marketplaces conectados.

### Query Parameters

<ParamField query="page" type="number" default="1">Paginação atual.</ParamField>
<ParamField query="limit" type="number" default="10">Resumo de itens retornados.</ParamField>

### Response

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "e4b6d4e8-8e6d-41da-abdb-8fc358a9e7f1",
        "tenantId": "e305e9a4-585e-49b8-bc88-9fba992c6326",
        "connectionId": "488fa4bd-9e19-4eb5-b461-abeb38a0f9de",
        "productId": "cffbca85-da89-4b2a-aecf-31422abcb34a",
        "externalId": "MLB12345678",
        "sku": "SKU-XPTO",
        "title": "Celular Smartphone Top de Linha",
        "price": 1500.00,
        "stock": 10,
        "status": "active",
        "permalink": "https://produto.mercadolivre.com.br/MLB...",
        "thumbnail": "https://http2.mlstatic.com/D_NQ...",
        "attributes": {},
        "lastSyncedAt": "2024-02-15T10:00:00.000Z"
      }
    ],
    "total": 1,
    "page": 1,
    "limit": 10
  }
  ```
</ResponseExample>


## OpenAPI

````yaml get /listings
openapi: 3.0.0
info:
  title: Hub Marketplace API
  description: API for managing marketplace listings and keys
  version: '1.0'
  contact: {}
servers: []
security: []
tags:
  - name: listings
    description: ''
paths:
  /listings:
    get:
      tags:
        - Listings
      operationId: ListingsController_findAll
      parameters:
        - name: page
          required: true
          in: query
          schema:
            type: number
        - name: limit
          required: true
          in: query
          schema:
            type: number
      responses:
        '200':
          description: ''

````