What you get
| Field | Type | Sample value |
|---|---|---|
title |
string | Skazani na Shawshank |
description |
string | Adaptacja opowiadania Stephena Kinga. Niesłusznie skazany na dożywocie bankier,… |
year |
integer | 1994 |
url |
string | filmweb.pl/film/Skazani+na+Shawshank-1994… |
image_url |
string | fwcdn.pl/fpo/10/48/1048/6925401_1.7.webp |
release_date |
string | premiera 10 września 1994 (Światowa) , 16 kwietnia 1995 (Polska premiera kinowa) |
position |
integer | 1 |
ranking_card_original_title_text |
string | The Shawshank Redemption |
All 27 fields
Key fields
titledescriptionyearurlimage_urlrelease_datepositionranking_card_original_title_textrating_countrating_valuebased_onbudgetcountry_of_productioncreator_namecreator_urlstudiotime_requiredworldwide_box_officescreenwritercast
Technical fields
iddetail_genredirector_namedirector_urloriginal_titlerelease_datessource_work
Every field with its type, and the schemas, are in contract.json.
Sample records
2 saved records. This is a saved sample, not a live run.
title |
description |
year |
url |
image_url |
release_date |
|---|---|---|---|---|---|
| Skazani na Shawshank | Adaptacja opowiadania Stephena Kinga. Niesłusznie skazany na dożywocie bankier,… | 1994 | filmweb.pl/film/Skazani+na+Shawshank-1994… | fwcdn.pl/fpo/10/48/1048/6925401_1.7.webp | premiera 10 września 1994 (Światowa) , 16 kwietnia 1995 (Polska premiera kinowa) |
| Bękarty wojny | W okupowanej przez nazistów Francji oddział złożony z Amerykanów żydowskiego po… | 2009 | filmweb.pl/film/B%C4%99karty+wojny-2009-1… | fwcdn.pl/fpo/77/47/137747/7276639_2.7.webp | — |
Scroll sideways to see more columns.
Inputs
-
categorytextOptional. Free text: any category the site serves, written with letters and hyphens, up to 32 characters. A name the site does not serve is refused with input_value_unverified. Leave it out for the default listing.
enrich_records is on by default and adds the fields that only appear on each record's detail page. Send false to read list fields only. See Run an API.
Request
POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c658ec16b7044fccf0594a64/endpoints/generated_c658ec16b7044fccf0594a64_search/run
curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c658ec16b7044fccf0594a64/endpoints/generated_c658ec16b7044fccf0594a64_search/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Idempotency-Key: UNIQUE_REQUEST_ID" \
-H "Content-Type: application/json" \
-d '{
"input": {
"category": "premiere"
},
"version": 1,
"max_items": 25
}'
Save the Idempotency-Key before you send, and reuse it only to retry the same request. The key needs the run scope. See Run a catalog API.
version pins major v1, whose newest minor (1.0) answers. Leave it out and the call runs on the latest major.
Changelog
-
v1.0 (major) ·
Use it from an AI agent
Open in your coding agent
Add CleanedWeb to your agent as an MCP server, such as a custom connector in Claude or ChatGPT, then sign in with your CleanedWeb account. The agent can then find this API, run it and read the records. An API key with the read and run scopes works too.
https://api.cleanedweb.com/mcp?profile=catalog
Then ask, for example: Use CleanedWeb to get 25 records from the Filmweb Articles API.
The agent calls get_api with generated_c658ec16b7044fccf0594a64, then run_api. Runs are charged like any other run. See Connect an MCP client.
Coverage
- Category
- News & content
Reach. A run reads until the source ends or your max_items, timeout_seconds or budget stops it.
CleanedWeb is not affiliated with Filmweb.