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

# API do Perplexity: respostas, citações e consultas de busca

> Faça uma pergunta ao Perplexity e receba a resposta, as fontes citadas, perguntas relacionadas, consultas de busca e mídia.

`PERPLEXITY` pergunta ao Perplexity e retorna a resposta com as fontes que ele citou e as buscas que seu modelo fez.

| | |
| - | - |
| taskType | `PERPLEXITY` |
| Lê | `prompt` (recorre a `query`) |
| Créditos | 1 |
| País | Opcional, padrão `US`. `CN` é recusado com `422 REGION_UNSUPPORTED`. |

## Requisição

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "PERPLEXITY", "payload": { "prompt": "best CRM for a small team", "country": "US", "include": { "searchQueries": true } } }'
```

## Resposta

| Campo | Tipo | Descrição |
| - | - | - |
| `text` | string | A resposta. Sempre presente. |
| `sources` | array | Fontes citadas: `position`, `url`, `label`, `description`. Sempre presente. |
| `related_queries` | string\[] | Perguntas de acompanhamento que o Perplexity sugere. |
| `search_model_queries` | array | As buscas que o modelo do Perplexity fez, cada uma `{ query, engine, limit }`. |
| `searchQueries` | string\[] | As mesmas buscas como strings simples. Só com `include.searchQueries`. |
| `images`, `videos` | array | Mídia mostrada com a resposta: `title`, `url`, `medium`, `image`, `thumbnail`, `source`, `image_width`, `image_height` e `duration` em um vídeo. |
| `markdown` | string | A resposta em Markdown, com as imagens no lugar. Só com `include.markdown`. |
| `rawResponse` | array | Eventos de stream já interpretados. Só com `include.rawResponse`. |

Em `images` e `videos`, `url` é a página de onde o item vem e `image` é a própria imagem.

Por exemplo:

```json theme={"theme":"css-variables"}
{
  "text": "HubSpot CRM and Pipedrive are the most common choices for small teams ...",
  "sources": [
    { "position": 1, "url": "https://www.example.com/crm-review", "label": "Best CRM for small teams", "description": "..." }
  ],
  "related_queries": ["Is HubSpot CRM free?"],
  "search_model_queries": [{ "query": "best CRM small team", "engine": "web", "limit": 8 }],
  "searchQueries": ["best CRM small team"]
}
```

`related_queries` são sugestões para o usuário. `search_model_queries` e `searchQueries` são o que o Perplexity de fato buscou.

## Flags include

| Flag | Efeito |
| - | - |
| `markdown` | Adiciona `markdown`. |
| `searchQueries` | Adiciona `searchQueries`. |
| `rawResponse` | Adiciona `rawResponse`. |
| `html` | Adiciona `html`, a tela que o Perplexity mostrou, por 0,25 crédito quando a página é armazenada. Veja [Páginas HTML](/pt/engines/html-pages.md). |
| `analysis` | Adiciona `analysis`, 1 crédito. Veja [Análise da resposta](/pt/engines/answer-analysis.md). |
| `citationAnalysis` | Executa uma [Citation Analysis](/pt/research/citation-analysis.md) sobre a resposta. |

`ads` e `shopping` não têm efeito. Veja [Markdown e respostas brutas](/pt/engines/response-options.md).

## Relacionados

* [Página do produto Perplexity](https://querying.ai/pt/engines/perplexity)
* [Visão geral dos mecanismos](/pt/engines/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.