> ## 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.

# Publicar muitas páginas

> Publique até 1.000 URLs de páginas de uma vez.



## OpenAPI

````yaml POST /v1/ai-rendering/sites/{id}/pages/batch
openapi: 3.1.0
info:
  title: querying.ai
  description: >-
    One API for every AI answer engine. Every task is asynchronous: submit, then
    collect the result via webhook or polling.
  version: 1.0.0
servers:
  - url: https://api.querying.ai
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/ai-rendering/sites/{id}/pages/batch:
    parameters:
      - name: id
        in: path
        required: true
        description: The site's id.
        schema:
          type: string
    post:
      tags:
        - AI Rendering
      summary: Publish many pages
      description: >-
        Publishes up to 1,000 page URLs of the site's host at once. New pages
        are rendered in turn, a few a minute, each charged like a page published
        by url under the API key that sent the batch. A URL the site already
        publishes counts as existing and is not rendered again.
      operationId: publishAiRenderingPages
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AiRenderingBatchRequest'
            example:
              urls:
                - https://www.example.com/products/1
                - https://www.example.com/products/2
      responses:
        '202':
          description: The new pages wait to be rendered.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AiRenderingBatchResponse'
              example:
                success: true
                accepted: 2
                existing: 0
                rejected: []
        '400':
          description: >-
            VALIDATION_ERROR: the body is not a JSON object or has an unknown
            field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: >-
            KEY_SCOPE_DENIED: the API key is limited to engines that leave out
            GEO_SCORE.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: 'NOT_FOUND: no site of the account with that id.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: 'VALIDATION_ERROR: urls is not an array of 1 to 1,000 URLs.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    AiRenderingBatchRequest:
      type: object
      required:
        - urls
      additionalProperties: false
      properties:
        urls:
          type: array
          minItems: 1
          maxItems: 1000
          items:
            type: string
            format: uri
          description: >-
            Pages of the site's host. Tracking parameters such as utm_* are
            dropped, and a path sent twice is one page.
    AiRenderingBatchResponse:
      type: object
      required:
        - success
        - accepted
        - existing
        - rejected
      properties:
        success:
          type: boolean
        accepted:
          type: integer
          description: New pages, waiting to be rendered.
        existing:
          type: integer
          description: URLs the site already publishes.
        rejected:
          type: array
          items:
            type: object
            required:
              - url
              - code
              - message
            properties:
              url:
                type: string
              code:
                type: string
                enum:
                  - INVALID_URL
                  - PAGE_LIMIT
                description: >-
                  INVALID_URL: not a page of the site's host. PAGE_LIMIT: the
                  site's page limit leaves no room for it.
              message:
                type: string
    ErrorResponse:
      type: object
      required:
        - success
        - error
      properties:
        success:
          type: boolean
          const: false
        error:
          $ref: '#/components/schemas/ErrorDetail'
    ErrorDetail:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Stable, safe to branch on. See the Errors guide for the full list.
        message:
          type: string
          description: For humans. May change.
        details:
          description: >-
            Context for the error. An array of `{field, message}` on most
            `VALIDATION_ERROR`s; an object elsewhere (for example `{id}` on
            `RESOURCE_NOT_FOUND`, `retryAfterSec` on 429 and 503 codes). Omitted
            when there is nothing to add.
          oneOf:
            - type: array
              items:
                type: object
                properties:
                  field:
                    type: string
                  message:
                    type: string
            - type: object
              additionalProperties: true
        timestamp:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your API key, sent as `Authorization: Bearer <key>`.'

````

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