> ## Documentation Index > Fetch the complete documentation index at: https://pricepirate.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Synchronisierungseinstellungen für Listings aktualisieren > Aktualisiert die Anzahl der täglichen Synchronisierungen und optionale Synchronisierungs- oder Boost-Zeitfenster für ein oder mehrere Listings. ## OpenAPI ````yaml /openapi.de.json patch /listings/snapshot-settings openapi: 3.1.0 info: title: PricePirate Admin API version: 1.0.0 description: >- Anfragelimits: Jeder Shop kann 60 Anfragen pro Minute über alle API-Schlüssel hinweg senden. Wenn das Limit überschritten wird, gibt die API 429 TOO_MANY_REQUESTS mit einem Retry-After-Header zurück. servers: - url: https://app.pricepirate.com/api/v1 security: - bearerAuth: [] tags: - name: reports x-group: Berichte - name: catalog x-group: Katalog - name: listings x-group: Listings - name: metrics x-group: Metriken - name: price-changes x-group: Preisänderungen - name: pricing x-group: Preisgestaltung - name: shop x-group: Shop - name: tracked-variants x-group: Überwachte Varianten paths: /listings/snapshot-settings: patch: tags: - listings summary: Synchronisierungseinstellungen für Listings aktualisieren description: >- Aktualisiert die Anzahl der täglichen Synchronisierungen und optionale Synchronisierungs- oder Boost-Zeitfenster für ein oder mehrere Listings. operationId: listings.updateSnapshotSettings parameters: - name: Idempotency-Key in: header description: >- Erforderlich für Schreibanfragen. Verwenden Sie denselben Schlüssel nur erneut, wenn Sie exakt dieselbe Anfrage wiederholen. required: true schema: type: string example: 7f8c2e9d-8c7f-4f2c-9f35-6cc1819a7f3f requestBody: description: >- Synchronisierungseinstellungen, die auf die ausgewählten Listing-Schlüssel angewendet werden sollen. required: true content: application/json: schema: type: object properties: listingKeys: type: array items: type: object properties: source: type: string enum: - IDEALO - GOOGLE_SHOPPING - KLARNA - PRICERUNNER - ALLEGRO - AMAZON country: type: string enum: - AE - AT - AU - BE - BG - BR - CA - CH - CN - CZ - DE - DK - ES - FI - FR - GR - HR - HU - IE - IN - IT - JP - NL - 'NO' - PL - PT - RO - MX - SE - SK - UK - US externalId: type: string required: - source - country - externalId additionalProperties: false minItems: 1 numberOfDailySnapshots: type: integer minimum: 1 maximum: 16 snapshotTimeRangeStart: oneOf: - type: string - type: 'null' snapshotTimeRangeEnd: oneOf: - type: string - type: 'null' boostTimeRangeEnabled: oneOf: - type: boolean - type: 'null' boostTimeRangeStart: oneOf: - type: string - type: 'null' boostTimeRangeEnd: oneOf: - type: string - type: 'null' boostFactor: oneOf: - type: number minimum: 2 maximum: 10 - type: 'null' required: - listingKeys - numberOfDailySnapshots additionalProperties: false example: listingKeys: - source: IDEALO country: DE externalId: '123456789' numberOfDailySnapshots: 4 snapshotTimeRangeStart: '2025-01-01T08:00:00Z' snapshotTimeRangeEnd: '2025-01-01T20:00:00Z' boostTimeRangeEnabled: true boostTimeRangeStart: '2025-01-01T12:00:00Z' boostTimeRangeEnd: '2025-01-01T15:00:00Z' boostFactor: 3 responses: '200': description: Erfolgreiche Antwort. headers: Idempotency-Replayed: description: >- Mit dem Wert true vorhanden, wenn eine Schreibantwort aus dem Idempotenz-Cache geliefert wurde. schema: type: string enum: - 'true' example: 'true' content: application/json: schema: {} example: listing: source: IDEALO country: DE externalId: '123456789' numberOfDailySnapshots: 4 listings: [] updatedCount: 1 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' default: $ref: '#/components/responses/DefaultError' components: responses: BadRequest: description: Ungültige Anfrage oder Validierungsfehler. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: BAD_REQUEST message: JSON body must be an object details: Validation details may be included for invalid inputs. requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f Unauthorized: description: Fehlendes oder ungültiges Bearer-Token. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: Missing or invalid Authorization header requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f Forbidden: description: Das Token ist gültig, aber die Anfrage ist nicht erlaubt. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: FORBIDDEN message: Forbidden requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f NotFound: description: Endpunkt oder Domain-Ressource wurde nicht gefunden. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: NOT_FOUND message: Resource not found requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f Conflict: description: >- Schreibkonflikt, einschließlich Wiederverwendung eines Idempotency-Key oder laufender Sperren. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: idempotency_key_reuse message: Idempotency-Key was already used for a different request requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f TooManyRequests: description: Anfragelimit überschritten. headers: Retry-After: description: Sekunden, die vor einem erneuten Versuch gewartet werden sollen. schema: type: string example: '60' content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: TOO_MANY_REQUESTS message: Rate limit exceeded requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f InternalServerError: description: Interner Serverfehler. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INTERNAL_SERVER_ERROR message: Internal server error requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f DefaultError: description: Unerwartete Fehlerantwort. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INTERNAL_SERVER_ERROR message: Internal server error requestId: 1b11c2c2-7c6f-44d9-9980-02a77681b91f schemas: Error: type: object additionalProperties: false required: - error properties: error: type: object additionalProperties: false required: - code - message - requestId properties: code: type: string description: >- Fehlercode zur Laufzeit. Beispiele sind BAD_REQUEST, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT, TOO_MANY_REQUESTS, INTERNAL_SERVER_ERROR, idempotency_key_required, idempotency_key_reuse und idempotency_key_in_progress. message: type: string details: description: >- Zusätzliche Validierungsdetails, typischerweise bei 400-Antworten vorhanden. requestId: type: string securitySchemes: bearerAuth: type: http scheme: bearer description: 'Public-API-Token, das als Authorization: Bearer übergeben wird.' ````