---
title: "Buscar no conteúdo dos arquivos do tema"
method: GET
path: "/{alias}/store/theme/files/search"
tags: ["Loja Virtual - Arquivos do tema"]
---

# Buscar no conteúdo dos arquivos do tema

`GET /{alias}/store/theme/files/search`

## Request

- Base URL: `https://api.dooki.com.br/v2`
- URL: `https://api.dooki.com.br/v2/{alias}/store/theme/files/search`
- Auth: API key in header `User-Token` and API key in header `User-Secret-Key`

Busca um texto ou uma expressão regular PCRE no conteúdo dos arquivos do tema em preview. Retorna no máximo 100 ocorrências.

## Path parameters

- `alias` string, required

## Query parameters

- `query` string, required
- `folder` string
- `extensions[]` string[]
- `case_sensitive` boolean
- `regex` boolean
- `max_files` integer

## Response `200`

Resultado da busca

- object
  - `data` object
    - `matches` object[]
      - `path` string
      - `line` integer
      - `snippet` string: Linha encontrada, cortada em 200 caracteres.
    - `files_scanned` integer: Arquivos lidos na busca.
    - `files_total` integer: Arquivos que atendem aos filtros.
    - `truncated` boolean: Indica que havia mais arquivos do que `max_files`.
    - `mode` 'literal' | 'regex'
  - `status` integer

## Other responses

- `400`: Falha na busca
- `403`: Loja suspensa, sem acesso ao editor de código ou usuário sem a permissão `manage_open_code`
- `422`: Parâmetros inválidos ou expressão regular inválida
- `429`: Limite de requisições excedido

## Changes

- **2026-11-03** `bbafb577e11c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yampi/apis/yampi-api/changes/:alias/store/theme/files/search/get.md)

---

[API](https://skmtc.dev/yampi/apis/yampi-api.md) - [All operations](https://skmtc.dev/yampi/apis/yampi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yampi/apis/yampi-api/revisions/74739ec8876f?raw)