{"name":"Filmweb Articles API","description":"Articles from filmweb.pl with image and title fields, plus filter inputs.","api_id":"generated_c658ec16b7044fccf0594a64","slug":"filmweb-articles-api","source":{"name":"Filmweb","domain":"filmweb.pl","url":"https://www.filmweb.pl/"},"category":"news_content","countries":[],"languages":[],"record_types":[],"tags":[],"limitations":[],"updated":"2026-11-18","note":"Sample records are saved samples, not a live run. CleanedWeb is not affiliated with the source.","version":"1.0","versions":[{"major":1,"latest_minor":"1.0","status":"current","sunset_at":null}],"changelog":[{"version":"1.0","date":"2026-11-17T15:32:37.000Z","kind":"major","changes":[]}],"version_note":"Pin a major with \"version\": N in the run body (an integer). Leave it out and the call runs on the latest major. A sunset major runs on the latest major and the response says rerouted. An unknown major answers 404 catalog_version_not_found and lists the available majors.","endpoints":[{"endpoint_id":"generated_c658ec16b7044fccf0594a64_search","name":"Extract records","description":"Return records within the accepted scope.","definition_version":"6eff4759bc857bdd6d9499b40450951a3f0163c776dae6e50c5c9e99036decc4","method":"POST","path":"/v1/catalog/public/apis/generated_c658ec16b7044fccf0594a64/endpoints/generated_c658ec16b7044fccf0594a64_search/run","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_c658ec16b7044fccf0594a64/endpoints/generated_c658ec16b7044fccf0594a64_search/run","authentication":{"type":"bearer","scheme":"Authorization: Bearer <API key>","scope":"run","note":"Reading this file and the live catalog needs no credential. A run needs a CleanedWeb account and uses the credits of its workspace.","docs":"https://cleanedweb.com/docs/run-catalog-api/"},"required_headers":[{"name":"Authorization","value":"Bearer YOUR_API_KEY","description":"An API key with the run scope."},{"name":"Idempotency-Key","value":"UNIQUE_REQUEST_ID","description":"Required. Save it before you send; reuse it only to retry the same request and to read the result. 1-200 characters: letters, numbers, . _ : -"},{"name":"Content-Type","value":"application/json","description":"The body is JSON."}],"request_body":{"input":"An object that follows input_schema.","max_items":"Optional. Stop after this many records.","timeout_seconds":"Optional, 60-86400, default 10800.","wait_seconds":"Optional, 0-86400, default 90. How long the request waits before answering 202.","version":"Optional integer major. Leave it out for the latest major."},"input_schema":{"type":"object","properties":{"enrich_records":{"type":"boolean","default":true,"description":"true: read each returned record's product/detail page and merge its fields into the record. false: return list/search-level fields only, with no detail page reads. Every returned record's detail page is read within the run's time budget; records the time budget leaves unread are returned without detail fields, and summary.record_enrichment reports how many records were enriched and why any were not (run_time_budget). Detail fields are optional."},"category":{"x-enum-labels":["Ranking nowości","Seriale top 500","Oryginalne produkcje","Gry wideo","Box office","Programów","Filmy i seriale HBO","Filmy i seriale Prime Video"],"x-value-status":["verified","observed","observed","verified","observed","observed","observed","observed"],"x-source-key":"category","type":"string","pattern":"^[A-Za-z][A-Za-z\\-]{0,31}$","minLength":1,"maxLength":32,"examples":["premiere","serial","netflix","game","boxOffice","tvshow","hbo","amazon"],"x-open-values":true,"description":"Optional. The name of a page of the same kind as the pages the pasted one links (any name that fits the pattern; the examples are the names it links). The site decides: a name it does not serve is refused as input_value_unverified. Omit for the pasted page (its own name asks for it too).","not":{"type":"string","pattern":"\\n"},"x-source-route":"path_segment"}},"required":[],"additionalProperties":false},"output_schema":{"type":"object","additionalProperties":false,"required":["title","url"],"properties":{"id":{"type":["string"]},"image_url":{"type":"string"},"position":{"type":"integer","description":"Numeric reading of source text such as '1.' (suffix '.' removed)"},"ranking_card_original_title_text":{"type":"string"},"rating_count":{"type":"string"},"rating_value":{"type":"number"},"title":{"type":"string"},"url":{"type":"string","format":"uri"},"year":{"type":"integer"},"based_on":{"type":"string"},"budget":{"type":"string"},"country_of_production":{"type":"string"},"creator_name":{"type":"string"},"creator_url":{"type":"string"},"description":{"type":"string"},"detail_genre":{"type":"string"},"director_name":{"type":"string"},"director_url":{"type":"string"},"original_title":{"type":"string"},"release_date":{"type":"string"},"studio":{"type":"string"},"time_required":{"type":"string"},"worldwide_box_office":{"type":"string"},"release_dates":{"type":"string"},"screenwriter":{"type":"string"},"source_work":{"type":"string"},"cast":{"type":"string"}}},"examples":[{"kind":"saved_validation_records","saved_at":"2026-11-17T15:32:37.269Z","live_verified":false,"request":{"input":{}},"records_shown":2,"records_saved":2,"records":[{"based_on":"studio  Castle Rock Entertainment (przedstawia)","budget":"budżet  $25 000 000","cast":"Andy Dufresne","country_of_production":"produkcja  USA","creator_name":"Frank Darabont","creator_url":"/person/Frank+Darabont-12189","description":"Adaptacja opowiadania Stephena Kinga. Niesłusznie skazany na dożywocie bankier, stara się przetrwać w brutalnym, więziennym świecie.","detail_genre":"Dramat","director_name":"Frank Darabont","director_url":"/person/Frank+Darabont-12189","id":"1048","image_url":"https://fwcdn.pl/fpo/10/48/1048/6925401_1.7.webp","original_title":"The Shawshank Redemption","position":1,"ranking_card_original_title_text":"The Shawshank Redemption","rating_count":"988 tys. ocen","rating_value":8.77,"release_date":"premiera    10 września 1994 (Światowa) ,   16 kwietnia 1995 (Polska premiera kinowa)","release_dates":"premiera    10 września 1994 (Światowa) ,   16 kwietnia 1995 (Polska premiera kinowa)","screenwriter":"scenariusz  Frank Darabont","source_work":"Stephen King","studio":"tytuł oryg. The Shawshank Redemption","time_required":"PT142M","title":"Skazani na Shawshank","url":"https://www.filmweb.pl/film/Skazani+na+Shawshank-1994-1048","worldwide_box_office":"boxoffice  $29 424 909 na świecie $28 767 189 w USA $657 720 poza USA","year":1994},{"based_on":"studio  Universal Pictures (przedstawia)  /  Weinstein Company, The (przedstawia)  /  A Band Apart / więcej","budget":"budżet  $70 000 000","cast":"Porucznik Aldo Raine","country_of_production":"produkcja  Niemcy,  USA","creator_name":"Quentin Tarantino","creator_url":"/person/Quentin+Tarantino-111","description":"W okupowanej przez nazistów Francji oddział złożony z Amerykanów żydowskiego pochodzenia planuje zamach na Hitlera.","detail_genre":"Wojenny","id":"137747","image_url":"https://fwcdn.pl/fpo/77/47/137747/7276639_2.7.webp","original_title":"Inglourious Basterds","position":51,"ranking_card_original_title_text":"Inglourious Basterds","rating_count":"641 tys. ocen","rating_value":7.99,"screenwriter":"scenariusz  Quentin Tarantino","studio":"tytuł oryg. Inglourious Basterds","time_required":"PT153M","title":"Bękarty wojny","url":"https://www.filmweb.pl/film/B%C4%99karty+wojny-2009-137747","worldwide_box_office":"boxoffice  $321 458 605 na świecie $120 540 719 w USA $200 917 886 poza USA","year":2009}]}],"request_example":{"body":{"input":{"category":"premiere"},"version":1,"max_items":25},"curl":"curl -X POST https://api.cleanedweb.com/v1/catalog/public/apis/generated_c658ec16b7044fccf0594a64/endpoints/generated_c658ec16b7044fccf0594a64_search/run \\\n  -H \"Authorization: Bearer YOUR_API_KEY\" \\\n  -H \"Idempotency-Key: UNIQUE_REQUEST_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"category\": \"premiere\"\n  },\n  \"version\": 1,\n  \"max_items\": 25\n}'"},"result":{"method":"GET","url":"https://api.cleanedweb.com/v1/catalog/public/apis/generated_c658ec16b7044fccf0594a64/endpoints/generated_c658ec16b7044fccf0594a64_search/result","note":"A run that does not end within wait_seconds answers 202. Read the result with the same API key and the same Idempotency-Key."},"links":{"page":"https://cleanedweb.com/catalog/filmweb-articles-api/","markdown":"https://cleanedweb.com/catalog/filmweb-articles-api/index.md","live_contract":"https://app.cleanedweb.com/api/catalog/apis/generated_c658ec16b7044fccf0594a64/endpoints/generated_c658ec16b7044fccf0594a64_search/contract","run_docs":"https://cleanedweb.com/docs/run-catalog-api/"}}],"links":{"page":"https://cleanedweb.com/catalog/filmweb-articles-api/","markdown":"https://cleanedweb.com/catalog/filmweb-articles-api/index.md","contract":"https://cleanedweb.com/catalog/filmweb-articles-api/contract.json","catalog":"https://cleanedweb.com/catalog/","index":"https://cleanedweb.com/catalog/index.json","openapi":"https://cleanedweb.com/catalog/openapi.json"}}
