Piloterr Cultura API
The Cultura API from Piloterr — 2 operation(s) for cultura.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/piloterr-com:piloterr-com-cultura-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Piloterr API Reference Cultura API
description: Complete API reference documentation.
version: 1.0.0
servers:
- url: https://api.piloterr.com
description: API Server
tags:
- name: Cultura
paths:
/v2/cultura/search:
get:
summary: Cultura Search
description: 'Search Cultura by keyword and page through books, games, and culture products. Cards include title, price, availability, and the product link.
**Credit cost:** 2 credits per call'
operationId: get-cultura-search
security:
- ApiKeyAuth: []
parameters:
- name: query
in: query
required: true
description: 'Words to search for on Cultura, or the search page link.
**Examples:**
```
harry potter
```
```
https://www.cultura.com/search/results?search_query=harry+potter
```
A product link (`/p-....html`) returns 400.'
schema:
type: string
description: 'Words to search for on Cultura, or the search page link.
**Examples:**
```
harry potter
```
```
https://www.cultura.com/search/results?search_query=harry+potter
```
A product link (`/p-....html`) returns 400.'
- name: page
in: query
required: false
description: 'Page number, starting at 1. For example, 2 returns the next page of results.
When query is a search link, a number above 1 replaces the page in that link.'
schema:
type: number
description: 'Page number, starting at 1. For example, 2 returns the next page of results.
When query is a search link, a number above 1 replaces the page in that link.'
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
type: object
properties:
sku:
type: string
url:
type: string
name:
type: string
badge:
type: string
brand:
type: string
image:
type: string
price:
type: number
rating:
nullable: true
currency:
type: string
position:
type: integer
availability:
type: string
review_count:
nullable: true
price_display:
type: string
new_offers_count:
nullable: true
new_offers_price:
nullable: true
used_offers_count:
nullable: true
used_offers_price:
nullable: true
new_offers_price_display:
nullable: true
used_offers_price_display:
nullable: true
pagination:
type: object
properties:
next:
type: string
page:
type: integer
per_page:
type: integer
total_pages:
type: integer
total_results:
type: integer
examples:
harry potter, first product:
value:
results:
- sku: '13432454'
url: https://www.cultura.com/p-harry-potter-a-l-ecole-des-sorciers-9782075253147.html
name: Harry Potter à l'école des sorciers
badge: Précommande
brand: J. K. Rowling
image: https://cdn.cultura.com/media/pim/13432454_8wuv0xn9_1_95486
price: 8.95
rating: null
currency: EUR
position: 1
availability: Précommande - sortie le 05/11/26
review_count: null
price_display: 8,95 €
new_offers_count: null
new_offers_price: null
used_offers_count: null
used_offers_price: null
new_offers_price_display: null
used_offers_price_display: null
pagination:
next: https://www.cultura.com/search/results?search_query=harry+potter&page=2
page: 1
per_page: 60
total_pages: 50
total_results: 3371
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Cultura
post:
summary: Cultura Search
description: 'Search Cultura by keyword and page through books, games, and culture products. Cards include title, price, availability, and the product link.
**Credit cost:** 2 credits per call'
operationId: post-cultura-search
security:
- ApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
query:
type: string
description: 'Words to search for on Cultura, or the search page link.
**Examples:**
```
harry potter
```
```
https://www.cultura.com/search/results?search_query=harry+potter
```
A product link (`/p-....html`) returns 400.'
page:
type: number
description: 'Page number, starting at 1. For example, 2 returns the next page of results.
When query is a search link, a number above 1 replaces the page in that link.'
required:
- query
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
results:
type: array
items:
type: object
properties:
sku:
type: string
url:
type: string
name:
type: string
badge:
type: string
brand:
type: string
image:
type: string
price:
type: number
rating:
nullable: true
currency:
type: string
position:
type: integer
availability:
type: string
review_count:
nullable: true
price_display:
type: string
new_offers_count:
nullable: true
new_offers_price:
nullable: true
used_offers_count:
nullable: true
used_offers_price:
nullable: true
new_offers_price_display:
nullable: true
used_offers_price_display:
nullable: true
pagination:
type: object
properties:
next:
type: string
page:
type: integer
per_page:
type: integer
total_pages:
type: integer
total_results:
type: integer
examples:
harry potter, first product:
value:
results:
- sku: '13432454'
url: https://www.cultura.com/p-harry-potter-a-l-ecole-des-sorciers-9782075253147.html
name: Harry Potter à l'école des sorciers
badge: Précommande
brand: J. K. Rowling
image: https://cdn.cultura.com/media/pim/13432454_8wuv0xn9_1_95486
price: 8.95
rating: null
currency: EUR
position: 1
availability: Précommande - sortie le 05/11/26
review_count: null
price_display: 8,95 €
new_offers_count: null
new_offers_price: null
used_offers_count: null
used_offers_price: null
new_offers_price_display: null
used_offers_price_display: null
pagination:
next: https://www.cultura.com/search/results?search_query=harry+potter&page=2
page: 1
per_page: 60
total_pages: 50
total_results: 3371
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Cultura
/v2/cultura/product:
get:
summary: Cultura Product
description: 'Read one Cultura product from its URL or SKU. You get price, EAN, seller, condition, and stock wording.
**Credit cost:** 2 credits per call'
operationId: get-cultura-product
security:
- ApiKeyAuth: []
parameters:
- name: query
in: query
required: true
description: 'Link of the Cultura product page.
**Example:**
```
https://www.cultura.com/p-harry-potter-et-le-prisonnier-d-azkaban-illustre-par-minalima-9782075193993.html
```
A search link returns 400.'
schema:
type: string
description: 'Link of the Cultura product page.
**Example:**
```
https://www.cultura.com/p-harry-potter-et-le-prisonnier-d-azkaban-illustre-par-minalima-9782075193993.html
```
A search link returns 400.'
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
ean:
type: string
sku:
type: string
url:
type: string
name:
type: string
badge:
type: string
brand:
type: string
image:
type: string
price:
type: number
images:
type: array
items:
type: string
seller:
type: string
currency:
type: string
condition:
type: string
breadcrumbs:
type: array
items:
type: object
properties:
url:
type: string
name:
type: string
description:
type: string
availability:
type: string
contributors:
type: array
items:
type: object
properties:
name:
type: string
role:
type: string
price_display:
type: string
favorite_count:
type: integer
examples:
Harry Potter et le prisonnier d'Azkaban:
value:
ean: '9782075193993'
sku: '10016146'
url: https://www.cultura.com/p-harry-potter-et-le-prisonnier-d-azkaban-illustre-par-minalima-9782075193993.html
name: 'Harry Potter Tome 3 : Harry Potter et le prisonnier d''Azkaban'
badge: Coup de cœur
brand: J. K. Rowling
image: https://cdn.cultura.com/media/pim/10016146_10vq8xg2_1_e5a37
price: 42.5
images:
- https://cdn.cultura.com/media/pim/10016146_10vq8xg2_1_e5a37
- https://cdn.cultura.com/media/pim/10016146_15393428
- https://cdn.cultura.com/media/pim/10016146_image_type_open_view_SODIS_10_FR_7cbe7
- https://cdn.cultura.com/media/pim/9782075193993_11.jpg
- https://cdn.cultura.com/media/pim/9782075193993_8.jpg
- https://cdn.cultura.com/media/pim/9782075193993_9.jpg
- https://cdn.cultura.com/media/pim/10016146_81758431
seller: Cultura
currency: EUR
condition: Neuf
breadcrumbs:
- url: https://www.cultura.com/
name: Accueil
- url: https://www.cultura.com/univers-enfant.html
name: Enfant
- url: https://www.cultura.com/univers-enfant/livres-enfant.html
name: Livres Enfants
- url: https://www.cultura.com/univers-enfant/livres-enfant/livres-des-9-ans.html
name: Livres pour enfants de 9 à 11 ans
- url: null
name: 'Harry Potter Tome 3 : Harry Potter et le prisonnier d''Azkaban'
description: 'Sublimes illustrations en couleurs et huit prouesses d''ingénierie papier interactives : une édition unique du deuxième tome de la saga Harry Potter et un précieux cadeau pour les fans de tous âges. Depuis douze longues années, l''infâme criminel Sirius Black, partisan de Lord Voldemort et reconnu coupable d''avoir tué treize personnes d''un coup, était enfermé dans la forteresse d''Azkaban. Mais il s''est évadé et il recherche Harry Potter. Les gardiens de la prison l''ont entendu murmurer dans son sommeil : "Il est à Poudlard..." Malgré les défenses magiques de l''école de sorcellerie, Harry Potter n''est en sécurité nulle part, même entouré de ses amis... car un traitre pourrait bien se cacher parmi eux.'
availability: en stock Cultura
contributors:
- name: J. K. Rowling
role: Auteur
- name: Minalima
role: Illustrateur
price_display: 42,50 €
favorite_count: 6
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Cultura
post:
summary: Cultura Product
description: 'Read one Cultura product from its URL or SKU. You get price, EAN, seller, condition, and stock wording.
**Credit cost:** 2 credits per call'
operationId: post-cultura-product
security:
- ApiKeyAuth: []
parameters:
- $ref: '#/components/parameters/fields'
- $ref: '#/components/parameters/is_async'
- $ref: '#/components/parameters/soft_fail'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
query:
type: string
description: 'Link of the Cultura product page.
**Example:**
```
https://www.cultura.com/p-harry-potter-et-le-prisonnier-d-azkaban-illustre-par-minalima-9782075193993.html
```
A search link returns 400.'
required:
- query
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
ean:
type: string
sku:
type: string
url:
type: string
name:
type: string
badge:
type: string
brand:
type: string
image:
type: string
price:
type: number
images:
type: array
items:
type: string
seller:
type: string
currency:
type: string
condition:
type: string
breadcrumbs:
type: array
items:
type: object
properties:
url:
type: string
name:
type: string
description:
type: string
availability:
type: string
contributors:
type: array
items:
type: object
properties:
name:
type: string
role:
type: string
price_display:
type: string
favorite_count:
type: integer
examples:
Harry Potter et le prisonnier d'Azkaban:
value:
ean: '9782075193993'
sku: '10016146'
url: https://www.cultura.com/p-harry-potter-et-le-prisonnier-d-azkaban-illustre-par-minalima-9782075193993.html
name: 'Harry Potter Tome 3 : Harry Potter et le prisonnier d''Azkaban'
badge: Coup de cœur
brand: J. K. Rowling
image: https://cdn.cultura.com/media/pim/10016146_10vq8xg2_1_e5a37
price: 42.5
images:
- https://cdn.cultura.com/media/pim/10016146_10vq8xg2_1_e5a37
- https://cdn.cultura.com/media/pim/10016146_15393428
- https://cdn.cultura.com/media/pim/10016146_image_type_open_view_SODIS_10_FR_7cbe7
- https://cdn.cultura.com/media/pim/9782075193993_11.jpg
- https://cdn.cultura.com/media/pim/9782075193993_8.jpg
- https://cdn.cultura.com/media/pim/9782075193993_9.jpg
- https://cdn.cultura.com/media/pim/10016146_81758431
seller: Cultura
currency: EUR
condition: Neuf
breadcrumbs:
- url: https://www.cultura.com/
name: Accueil
- url: https://www.cultura.com/univers-enfant.html
name: Enfant
- url: https://www.cultura.com/univers-enfant/livres-enfant.html
name: Livres Enfants
- url: https://www.cultura.com/univers-enfant/livres-enfant/livres-des-9-ans.html
name: Livres pour enfants de 9 à 11 ans
- url: null
name: 'Harry Potter Tome 3 : Harry Potter et le prisonnier d''Azkaban'
description: 'Sublimes illustrations en couleurs et huit prouesses d''ingénierie papier interactives : une édition unique du deuxième tome de la saga Harry Potter et un précieux cadeau pour les fans de tous âges. Depuis douze longues années, l''infâme criminel Sirius Black, partisan de Lord Voldemort et reconnu coupable d''avoir tué treize personnes d''un coup, était enfermé dans la forteresse d''Azkaban. Mais il s''est évadé et il recherche Harry Potter. Les gardiens de la prison l''ont entendu murmurer dans son sommeil : "Il est à Poudlard..." Malgré les défenses magiques de l''école de sorcellerie, Harry Potter n''est en sécurité nulle part, même entouré de ses amis... car un traitre pourrait bien se cacher parmi eux.'
availability: en stock Cultura
contributors:
- name: J. K. Rowling
role: Auteur
- name: Minalima
role: Illustrateur
price_display: 42,50 €
favorite_count: 6
'400':
description: Bad Request — missing or invalid parameters.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Bad Request
'401':
description: Unauthorized — the API key is missing, invalid, inactive, or expired, or a rate limit was exceeded (`Rate limit exceeded…` message).
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
examples:
invalidKey:
value:
error: Invalid API Key
planRateLimit:
value:
error: 'Rate limit exceeded: You''ve exceeded the per second rate limit on your subscription'
keyQuota:
value:
error: 'Rate limit exceeded for the API key: quota monthly'
'402':
description: Payment Required — your subscription or credit balance is insufficient.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Payment required
'500':
description: Internal Server Error — something went wrong on our side.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error: Internal Error
tags:
- Cultura
components:
parameters:
fields:
name: fields
in: query
required: false
description: Comma-separated list of response fields to return, with dot notation for nested fields (e.g. `name,location.city`).
schema:
type: string
is_async:
name: is_async
in: query
required: false
description: 'Run the request as a background job: the API answers `202` with a `job_id` to poll on `GET /v1/jobs/{id}`.'
schema:
type: boolean
default: false
soft_fail:
name: soft_fail
in: query
required: false
description: Return HTTP 200 even when the request fails; the error is in the `error` field of the body.
schema:
type: boolean
default: false
schemas:
ErrorResponse:
type: object
required:
- error
properties:
error:
type: string
description: Human-readable error message.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: x-api-key
description: Your API key. Include it in the x-api-key header for every request.