> ## 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. # 배치 항목 목록 > 배치의 항목과 결과를 페이지 단위로 받습니다. ## OpenAPI ````yaml GET /v1/batches/{id}/items 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/batches/{id}/items: get: tags: - Tasks summary: List batch items description: >- Items in submission order, a page at a time. Pass `nextCursor` back as `cursor` until it is null. With `include=response` each finished item carries its task's result. operationId: listBatchItems parameters: - name: id in: path required: true description: The batch id returned by POST /v1/batches. schema: type: string format: uuid - name: cursor in: query required: false schema: type: string description: '`nextCursor` from the previous page.' - name: limit in: query required: false schema: type: integer minimum: 1 maximum: 1000 description: >- Items per page: default 100, up to 1,000; with `include=response` default 20, up to 100. - name: status in: query required: false schema: type: string enum: - pending - queued - processing - completed - failed - rejected - name: include in: query required: false schema: type: string enum: - response responses: '200': description: One page of items. content: application/json: schema: $ref: '#/components/schemas/BatchItemsResponse' example: success: true nextCursor: '99' items: - index: 0 customId: shoes-chatgpt-us taskType: CHATGPT status: COMPLETED taskId: 8f2c1e40-0000-0000-0000-000000000000 completedAt: '2026-10-09T09:01:02.000Z' - index: 1 customId: shoes-gemini-us taskType: GEMINI status: QUEUED taskId: 1b7d9c22-0000-0000-0000-000000000000 '400': description: Invalid cursor, limit or status. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': $ref: '#/components/responses/Unauthorized' '404': description: No batch with this id belongs to your account. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: RESOURCE_NOT_FOUND message: Batch not found timestamp: '2026-10-09T09:00:00.000Z' components: schemas: BatchItemsResponse: type: object required: - success - items - nextCursor properties: success: type: boolean const: true items: type: array items: $ref: '#/components/schemas/BatchItem' nextCursor: type: - string - 'null' description: Pass as `cursor` for the next page; null on the last page. ErrorResponse: type: object required: - success - error properties: success: type: boolean const: false error: $ref: '#/components/schemas/ErrorDetail' BatchItem: type: object required: - index - taskType - status properties: index: type: integer description: Position in the submitted `items` array. customId: type: string taskType: $ref: '#/components/schemas/TaskType' status: type: string enum: - PENDING - QUEUED - PROCESSING - COMPLETED - FAILED - REJECTED taskId: type: string format: uuid description: Also readable with GET /v1/async/task/{id}. completedAt: type: string format: date-time error: type: object description: >- Why the item was rejected, or the task's error when `include=response`. response: type: object description: >- With `include=response`: the task's result, as GET /v1/async/task/{id} returns it, for one day after the task completes. 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 TaskType: type: string description: >- The engine to query. `NAVER` is a deprecated alias for `NAVER_AI_BRIEF`. GOOGLE_AIO and GOOGLE_AIMODE are the unified names for GOOGLE and AIMODE; both spellings are accepted and responses echo the canonical GOOGLE / AIMODE. `NAVER_AI_MODE` is accepted as an earlier spelling of `NAVER_AI_TAB`. `GOOGLE_SERP` returns the Google results page without the AI Overview; `payload.page` selects pages 1-10. `NAVER_SERP` returns Naver's web results, 15 per page (`payload.page` 1-10), and with `payload.action` `page` reads one naver.com page by `payload.url`. `REDDIT` searches Reddit posts by `query` (optionally within one `subreddit`), reads one post with its first page of comments by `url`, or lists posts with `action` `feed` or `user_posts`. `WEB_SCRAPE` reads one web page by `payload.url` and returns its main content as Markdown with its images. `WEB_MAP` lists a site's addresses from its start page links and sitemaps. `WEB_CRAWL` reads a site's pages under a start address, each as WEB_SCRAPE reads it, at 1 credit per page returned. `KEYWORD_VOLUME` returns the monthly search volume of `payload.keywords` (1-100) in `payload.country`: Naver for KR and Google for 216 other countries. `META_AI` returns the meta.ai chat answer with its cited sources, search queries and the products it shows (`shoppingCards`, `inlineProducts`); a prompt Meta refuses completes with an empty text and a `notice` quoting Meta. `QWEN` returns the answer of Qwen's China web chat (qianwen.com) with its web search, sources and search queries; `payload.country` sets the exit and the answer locale. `DOUBAO` returns the answer of Doubao's China web chat (doubao.com) with its web search, sources and search queries; it always asks from mainland China, whatever `payload.country` is. `BING` and `BING_COPILOT_SEARCH` are accepted as earlier spellings of `BING_SEARCH`, and `COPILOT` as the earlier spelling of `BING_COPILOT`; responses echo the new names. Private engines (for example CLAUDE) are rejected with 403 ENGINE_PRIVATE. CITATION_ANALYSIS, PROMPT_RESEARCH and GEO_SCORE tasks are created through their own endpoints (POST /v1/citation-analysis, POST /v1/prompt-research, POST /v1/geo-score) and are rejected here with 400 USE_DEDICATED_ENDPOINT; they appear in this list because their tasks report them. GEO_AUDIT, SOURCE_INFLUENCE and CITATION_ATTRIBUTION are accepted as earlier names of CITATION_ANALYSIS; responses echo CITATION_ANALYSIS. enum: - CHATGPT - PERPLEXITY - GEMINI - AIMODE - GOOGLE_AIMODE - GOOGLE - GOOGLE_AIO - GOOGLE_SERP - NAVER_AI_BRIEF - NAVER_AI_TAB - NAVER_AI_MODE - NAVER - NAVER_SERP - COMMERCE_SERP - COMMERCE_PRODUCT - BING_SEARCH - BING - BING_COPILOT_SEARCH - BING_COPILOT - COPILOT - META_AI - QWEN - DOUBAO - REDDIT - WEB_SCRAPE - WEB_MAP - WEB_CRAWL - KEYWORD_VOLUME - CITATION_ANALYSIS - GEO_AUDIT - SOURCE_INFLUENCE - CITATION_ATTRIBUTION - PROMPT_RESEARCH - GEO_SCORE responses: Unauthorized: description: Missing or invalid bearer token. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: code: MISSING_API_KEY message: Missing or invalid API key timestamp: '2026-07-09T04:12:00.000Z' securitySchemes: bearerAuth: type: http scheme: bearer description: 'Your API key, sent as `Authorization: Bearer `.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.