> ## 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. # Pesquisar endpoints executáveis > Encontre Endpoints para os dados de que você precisa e compare Providers e Prices. A pesquisa retorna maneiras de recuperar dados; ela não recupera os dados em si. Escolha um candidato e [inspecione-o](https://glasser.ai/docs/pt/api-reference/endpoints/inspect.md) antes de executá-lo. Se os resultados não forem adequados, tente palavras-chave diferentes; pontuações baixas ou a última página não provam que uma capacidade esteja indisponível. ## OpenAPI ````yaml /openapi.pt.json post /v1/endpoints/search openapi: 3.1.0 info: title: Glasser version: 0.0.1 description: >- Uma chave, sem contrato, pagamento por chamada, para todas as APIs pagas adquiridas no atacado. Cada resposta contém x-request-id; cada corpo de erro contém o mesmo envelope. servers: - url: https://api.glasser.ai security: [] tags: - name: Solutions - name: Endpoints - name: Runs - name: Balance paths: /v1/endpoints/search: post: tags: - Endpoints summary: Pesquisar endpoints executáveis description: >- Encontre endpoints executáveis por palavra-chave; isso retorna candidatos a endpoint, não dados de negócio. Os resultados são classificados por relevância, filtrados pela Policy da sua Key e incluem provedor de dados, versão do endpoint, Price e modo de execução. Compare os candidatos e use Inspect antes de executar. Use next_cursor para obter mais resultados. Pontuações baixas ou a última página não comprovam que uma capacidade esteja ausente; tente palavras-chave diferentes. Reutilize o task_id retornado em chamadas posteriores para a mesma task. operationId: endpoints-search parameters: [] requestBody: content: application/json: schema: type: object properties: query: anyOf: - type: string description: >- Palavras-chave que descrevem os dados necessários. Omita ou deixe vazio para navegar por todos os endpoints permitidos pela Policy da sua Key. - type: 'null' limit: anyOf: - type: integer minimum: 1 maximum: 20 description: 'Máximo de resultados por página. Padrão: 5; máximo: 20.' - type: 'null' cursor: anyOf: - type: string description: >- O next_cursor da resposta anterior. Use a mesma consulta; um cursor de outra consulta retorna 400. - type: 'null' task_id: anyOf: - type: string description: >- A tarefa à qual esta busca pertence. Uma busca sem task_id inicia uma nova tarefa. A resposta retorna o task_id. Envie-o em todas as buscas, inspeções e execuções posteriores do mesmo trabalho. Qualquer string estável é aceita. - type: 'null' metadata: anyOf: - anyOf: - type: object additionalProperties: type: string minLength: 1 maxLength: 500 maxProperties: 20 propertyNames: type: string pattern: ^[a-z][a-z0-9_]{0,39}$ - {} description: >- Campos de rastreamento opcionais, retornados no Run e disponíveis como filtros. Eles nunca são enviados ao provedor de dados nem afetam o roteamento, o preço ou a idempotência. - Até 20 chaves: letras minúsculas, dígitos e sublinhados; devem começar com uma letra; no máximo 40 caracteres. - Valores: strings de 1 a 500 caracteres. - user_id: o ID opaco do seu usuário final, nunca o endereço de e-mail ou o nome. Entradas inválidas são descartadas por inteiro, não truncadas. A solicitação continua, e o Run retorna os campos armazenados. - type: 'null' use_case: type: string minLength: 1 description: >- Obrigatório em toda busca. O caso de uso por trás desta busca: o que o usuário pediu, nas próprias palavras, incluindo o assunto — a empresa, o domínio, o ticker, o local ou o tópico. Encurte uma solicitação longa em vez de reescrevê-la. required: - use_case additionalProperties: false required: true responses: '200': description: Sucesso content: application/json: schema: type: object properties: data: type: array items: type: object properties: provider: type: string pattern: ^[a-z0-9][a-z0-9-]*$ provider_label: type: string description: >- O nome da marca do provedor de dados, para exibição: "People Data Labs" para o provedor "pdl". A identidade permanece com `provider` — esse é o valor usado por run e inspect, e ele nunca é enviado de volta. endpoint: type: string pattern: ^\/.+$ endpoint_version: type: integer exclusiveMinimum: 0 description: >- Versão compatível do endpoint. Atualizações compatíveis mantêm esta versão. name: type: string description: type: string tags: type: array items: type: string price: type: object properties: rule: anyOf: - type: object properties: type: type: string enum: - flat amount_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. required: - type - amount_usd additionalProperties: false - type: object properties: type: type: string enum: - per_result per_result_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. cap_usd: anyOf: - type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. - type: 'null' partial_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. required: - type - per_result_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - per_token per_million_input_tokens_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. cap_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. required: - type - per_million_input_tokens_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - base_plus_per_result base_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. included_results: type: integer minimum: 0 per_extra_result_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. cap_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. unit: type: string required: - type - base_usd - included_results - per_extra_result_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - metered base_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. cap_usd: anyOf: - type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. - type: 'null' base_kind: type: string enum: - starting required: - type - base_usd - cap_usd additionalProperties: false - type: object properties: type: type: string enum: - per_event events: type: object additionalProperties: type: object properties: usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. title: type: string required: - usd - title additionalProperties: false base_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. cap_usd: type: string pattern: >- ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. required: - type - events - base_usd - cap_usd additionalProperties: false - type: object properties: type: type: string required: - type allOf: - type: object additionalProperties: {} display: type: object properties: amount_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. unit: type: string cap_usd: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. required: - amount_usd - unit additionalProperties: false charges: type: object properties: NO_RESULT: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. PROVIDER_ERROR: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. TIMED_OUT: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. INTERNAL: type: string pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$ description: >- String decimal exata em USD (mínimo de 2 e máximo de 6 casas decimais, com uma única grafia canônica). Some com aritmética decimal ou escale por 10^6 — nunca use números de ponto flutuante. required: - NO_RESULT - PROVIDER_ERROR - TIMED_OUT - INTERNAL additionalProperties: false required: - rule - display - charges additionalProperties: false description: >- Price atual e regras de cobrança. O Price pode mudar sem alteração da versão do endpoint. Novos Runs usam o Price vigente na admissão; Runs aceitos mantêm esse Price. run_mode: type: string enum: - sync - async timeout_ms: anyOf: - type: integer exclusiveMinimum: 0 description: >- Para endpoints síncronos, o tempo máximo, em milissegundos, entre uma solicitação de Run e sua resposta terminal. Defina o timeout do cliente HTTP acima desse valor. - type: 'null' score: anyOf: - anyOf: - type: number - type: string enum: - Infinity - '-Infinity' - NaN - type: 'null' description: >- Similaridade de cosseno entre a consulta e o texto pesquisável deste endpoint, em [-1, 1]; null quando a pontuação semântica não foi executada. É um sinal de similaridade para comparar linhas, não um veredito: o ranking combina dois componentes, e nem uma pontuação baixa nem o fim dos resultados indicam que uma capacidade esteja ausente. required: - provider - provider_label - endpoint - endpoint_version - name - description - tags - price - run_mode - score additionalProperties: false description: >- Resumos de endpoints classificados por relevância e filtrados pela Policy da sua Key. O Price não afeta a classificação. client: type: object properties: client_version: anyOf: - type: string - type: 'null' minimum_version: type: string latest_version: type: string upgrade_command: type: string reason: type: string required: - client_version - minimum_version - latest_version - upgrade_command - reason additionalProperties: false next_cursor: anyOf: - type: string - type: 'null' description: >- Envie este valor como cursor para obter a próxima página. Null significa que não há mais páginas. total: type: integer minimum: 0 description: >- Número total de candidatos classificados em todas as páginas. task_id: type: string description: >- A task à qual esta pesquisa foi registrada — a que você enviou ou uma recém-criada, caso não tenha enviado nenhuma. Envie-a novamente em todas as chamadas posteriores de search, inspect e run para o mesmo trabalho. required: - data - next_cursor - total - task_id additionalProperties: false '400': description: ValidationFailed content: application/json: schema: anyOf: - $ref: '#/components/schemas/ValidationFailedEncoded' - $ref: '#/components/schemas/ValidationFailedEncoded' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/UnauthorizedEncoded' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ForbiddenEncoded' '429': description: RateLimited content: application/json: schema: $ref: '#/components/schemas/RateLimitedEncoded' security: - bearer: [] components: schemas: ValidationFailedEncoded: type: object properties: error: type: object properties: code: type: string enum: - validation_failed message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false UnauthorizedEncoded: type: object properties: error: type: object properties: code: type: string enum: - unauthorized message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false ForbiddenEncoded: type: object properties: error: type: object properties: code: type: string enum: - forbidden message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false RateLimitedEncoded: type: object properties: error: type: object properties: code: type: string enum: - rate_limited message: type: string reason: anyOf: - type: string - type: 'null' control: anyOf: - type: string - type: 'null' retry_after_ms: anyOf: - anyOf: - type: integer - type: 'null' - type: 'null' details: anyOf: - type: object - type: 'null' required: - code - message additionalProperties: false request_id: type: string required: - error - request_id additionalProperties: false securitySchemes: bearer: type: http scheme: Bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.