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

# Chamar um endpoint específico

Chame um endpoint conhecido do seu backend por meio da **HTTP API**. Nenhum Agent é necessário.

**Seu backend**Endpoint fixo
→
**Glasser**HTTP API
→
**Provedor de dados**Dados

## Chamar um endpoint

Exemplo: receber um nome de usuário do Instagram do seu app e recuperar as publicações públicas mais recentes.

**1. Conecte seu backend**

**URL base:** `https://api.glasser.ai`\\

**Cabeçalho:** `Authorization: Bearer <your Key>`

**Conta do seu produto:** use a [Key](https://app.glasser.ai/keys) do seu Workspace.\\

**Conta do seu usuário:** selecione a Key desse usuário em cada solicitação.

Armazene as Keys no seu backend. Verifique a conexão com uma solicitação gratuita
[GET /v1/balance](https://glasser.ai/docs/pt/api-reference/balance/get.md).

**2. Inspecione o Endpoint uma vez durante a configuração**

Envie JSON para [POST /v1/endpoints/inspect](https://glasser.ai/docs/pt/api-reference/endpoints/inspect.md):

```json wrap theme={null}
{
  "provider": "apify",
  "endpoint": "/apify/instagram-post-scraper"
}
```

**Obtenha:** o esquema de entrada e o Price atual. Este endpoint requer `username`,
um array contendo um nome de usuário. A inspeção é gratuita.

**3. Chame-o a partir do seu produto**

Envie JSON para [POST /v1/runs](https://glasser.ai/docs/pt/api-reference/runs/create.md). Use o mesmo
cabeçalho de autorização, `Content-Type: application/json`, e um
cabeçalho `Idempotency-Key` exclusivo para esta execução pretendida.

```json wrap theme={null}
{
  "provider": "apify",
  "endpoint": "/apify/instagram-post-scraper",
  "input": { "username": ["mkbhd"] }
}
```

Substitua `mkbhd` pela entrada do seu usuário.

**Obtenha:** um Run com `id`, `status` e `charge_usd`. Quando estiver pronto, `output`
conterá até 10 publicações públicas com legendas, contagens de curtidas e contagens de comentários.

Para `QUEUED` ou `RUNNING`, [leia esse Run](https://glasser.ai/docs/pt/api-reference/runs/get.md) até
que ele atinja um estado terminal. Os Runs usam o saldo do Workspace conectado.

> [accordion] Repetições e tratamento da resposta
>
> * Defina `endpoint_version` a partir de Inspect ou omita-o para usar a versão padrão.
>   Uma versão não fixa o Price; novos Runs usam o Price no momento da admissão.
> * Tente novamente a mesma solicitação com o **mesmo `Idempotency-Key`** e a mesma entrada. Continue
>   lendo um Run inacabado em vez de criar outro.
> * Verifique `status` e `provider_response.http_status` antes de usar
>   `output`. Um Run `COMPLETED` ainda pode conter um erro do provedor de dados.
> * Mantenha o ID do Run e `charge_usd` junto ao registro da solicitação do seu produto.
>   Um Run com falha ainda pode gerar uma cobrança conforme o Price do endpoint.
> * Mantenha a Key de cada usuário separada. Selecione-a a partir da conexão autenticada do usuário,
>   não dos campos de entrada da solicitação.

## Consultar APIs de provedores de dados

Escolha um endpoint em [Data Sources](https://glasser.ai/data-sources) e faça
Inspect para consultar o esquema. Você pode reutilizá-lo sem pesquisar antes de cada Run.

Para listar provedores de dados e endpoints no código, use
[GET /public/catalog](https://glasser.ai/docs/pt/api-reference/endpoints/list.md). Nenhuma Key é necessária, e
as solicitações são gratuitas:

```bash wrap theme={null}
curl https://api.glasser.ai/public/catalog
```

* **`providers`:** nomes e descrições dos provedores de dados e contagens de endpoints.
* **`entries`:** identificadores, descrições, categorias e preços de exibição dos endpoints.
  Faça a correspondência de `provider` para encontrar os endpoints de um provedor de dados.
* **Uma resposta:** a lista pública completa, sem paginação.

A resposta é armazenada em cache e não aplica a Policy da sua Key. Use
[Inspect](https://glasser.ai/docs/pt/api-reference/endpoints/inspect.md) com sua Key para consultar o esquema de entrada e o Price atual do
endpoint selecionado antes de executá-lo.

## Opcional: Solutions

A **GTM Solution** oferece seis recursos fixos por HTTP. O Glasser gerencia
a seleção de endpoints, o mapeamento de entradas e o fallback para falhas compatíveis.

* [Web research](https://glasser.ai/docs/pt/api-reference/solutions/gtm/web_research.md) — pesquisa na web, notícias e conteúdo de páginas.
* [Company intelligence](https://glasser.ai/docs/pt/api-reference/solutions/gtm/company_intelligence.md) — informações de empresas por domínio.
* [People search](https://glasser.ai/docs/pt/api-reference/solutions/gtm/people_search.md) — informações de contato de pessoas e empresas.
* [SEO research](https://glasser.ai/docs/pt/api-reference/solutions/gtm/seo_research.md) — palavras-chave, classificações e backlinks.
* [Social research](https://glasser.ai/docs/pt/api-reference/solutions/gtm/social_research.md) — perfis, publicações e pesquisas em redes sociais.
* [Market data](https://glasser.ai/docs/pt/api-reference/solutions/gtm/market_data.md) — dados de propriedades e cotações de ações.

Cada Capability tem sua própria API em `/v1/solutions/gtm/`. Use a mesma Key e
um cabeçalho `Idempotency-Key`; a resposta é um Run. Consulte a
[visão geral de Solutions](https://glasser.ai/docs/pt/api-reference/solutions/overview.md) para ver um exemplo e as
regras de seleção do provedor de dados.


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