Filmaffinity API Data

API ID 12716

FilmAffinity API to search titles, discover content with advanced filters, and retrieve detailed item data in JSON. Supported languages: Español and English. Not affiliated with FilmAffinity.

100% uptime 1,061 ms avg response

API Documentation

Endpoints

Request

GET /v1/search lets users find movies and TV titles on FilmAffinity using a text query. Send search and get structured results with title, year, type, poster, and others... Optional cache_bd controls whether database cache is read/updated.

Endpoint ID: 24798
GET https://api-sneakers-database.zylalabs.com/api/12716/filmaffinity+api+data/24798/search
INPUT PARAMETERS

Search — Endpoint Features

Object Description
search Required Search query: spiderman, breaking bad, Braveheart...
lang Optional Select only one: es (spanish) or en (english)
cache_bd Optional Select: Speed-optimized (true) or Freshness-optimized (false)

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

search
lang
cache_bd
API EXAMPLE RESPONSE
JSON
{"search":"matrix","lang":"es","count":27,"results":[{"id":932476,"title":"Matrix","year":2003,"rating":7.9,"poster_url":"https://pics.filmaffinity.com/the_matrix-155050517-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film932476.html"},{"id":257620,"title":"Matrix Revolutions","year":2003,"rating":6.0,"poster_url":"https://pics.filmaffinity.com/the_matrix_revolutions-289564524-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film257620.html"},{"id":349820,"title":"Matrix Reloaded","year":2003,"rating":6.4,"poster_url":"https://pics.filmaffinity.com/the_matrix_reloaded-133935821-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film349820.html"},{"id":768114,"title":"Animatrix","year":2021,"rating":7.0,"poster_url":"https://pics.filmaffinity.com/the_animatrix-650689548-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film768114.html"},{"id":517462,"title":"Matrix Resurrections","year":2023,"rating":4.9,"poster_url":"https://pics.filmaffinity.com/the_matrix_resurrections-864937945-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film517462.html"},{"id":302605,"title":"Generación Matrix","year":2001,"rating":6.0,"poster_url":"https://pics.filmaffinity.com/matrix_generation-228019227-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film302605.html"},{"id":925055,"title":"Matrix: Descubre lo increíble","year":2021,"rating":7.6,"poster_url":"https://pics.filmaffinity.com/the_matrix_revisited-243511978-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film925055.html"},{"id":973882,"title":"El despertar de Matrix","year":2021,"rating":6.0,"poster_url":"https://pics.filmaffinity.com/the_matrix_awakens_an_unreal_engine_5_experience-780018748-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film973882.html"},{"id":677637,"title":"Un fallo en Matrix","year":2020,"rating":4.9,"poster_url":"https://pics.filmaffinity.com/a_glitch_in_the_matrix-679629363-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film677637.html"},{"id":252286,"title":"Matrix","year":2014,"rating":null,"poster_url":"https://pics.filmaffinity.com/matrix-680794185-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film252286.html"},{"id":412933,"title":"8 Bit Cinema: Matrix","year":2003,"rating":5.1,"poster_url":"https://pics.filmaffinity.com/8_bit_cinema_the_matrix-755722543-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film412933.html"},{"id":852260,"title":"Enter the Matrix","year":2005,"rating":6.2,"poster_url":"https://pics.filmaffinity.com/enter_the_matrix-949071602-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film852260.html"},{"id":874332,"title":"The Matrix: Path of Neo","year":2002,"rating":6.4,"poster_url":"https://pics.filmaffinity.com/the_matrix_path_of_neo-991591913-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film874332.html"},{"id":378590,"title":"Armitage: Dual-Matrix","year":2004,"rating":6.0,"poster_url":"https://pics.filmaffinity.com/armitage_dual_matrix-572317944-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film378590.html"},{"id":862141,"title":"Matrix Revolutions: descubre lo increíble","year":2004,"rating":null,"poster_url":"https://pics.filmaffinity.com/the_matrix_revolutions_revisited-192893260-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film862141.html"},{"id":220539,"title":"Matrix Reloaded: descubre lo increíble","year":1993,"rating":6.8,"poster_url":"https://pics.filmaffinity.com/the_matrix_reloaded_revisited-664731561-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film220539.html"},{"id":697409,"title":"Matrix","year":1999,"rating":null,"poster_url":"https://pics.filmaffinity.com/matrix-589380290-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film697409.html"},{"id":121121,"title":"V-World Matrix","year":1999,"rating":null,"poster_url":"https://pics.filmaffinity.com/v_world_matrix-977654208-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film121121.html"},{"id":474456,"title":"Matrix","year":1972,"rating":null,"poster_url":"https://pics.filmaffinity.com/matrix-748504457-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film474456.html"},{"id":224302,"title":"Matrix III","year":1988,"rating":null,"poster_url":"https://pics.filmaffinity.com/matrix_iii-557974280-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film224302.html"},{"id":196628,"title":"Chess Boxing Matrix","year":1973,"rating":null,"poster_url":"https://pics.filmaffinity.com/jiang_shi_zhuo_yao-117721499-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film196628.html"},{"id":184647,"title":"Matrix","year":1973,"rating":null,"poster_url":"https://pics.filmaffinity.com/matrix-390375654-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film184647.html"},{"id":206481,"title":"Matrix","year":1971,"rating":null,"poster_url":"https://pics.filmaffinity.com/matrix-379968313-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film206481.html"},{"id":929746,"title":"Matrix II","year":1971,"rating":null,"poster_url":"https://pics.filmaffinity.com/matrix_ii-932706612-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film929746.html"},{"id":688830,"title":"Matrix I","year":2004,"rating":null,"poster_url":"https://pics.filmaffinity.com/matrix_i-902470513-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film688830.html"},{"id":894555,"title":"Cyber Wars","year":1996,"rating":3.7,"poster_url":"https://pics.filmaffinity.com/avatar_cyber_wars-620341084-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film894555.html"},{"id":595148,"title":"Darkdrive","year":1996,"rating":null,"poster_url":"https://pics.filmaffinity.com/darkdrive-249795498-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film595148.html"}],"cached":true,"warming":false,"retry_after":null,"message":null}
Search — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/12716/filmaffinity+api+data/24798/search?search=matrix&lang=es&cache_bd=true' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

GET /v1/item by URL endpoint allows clients to retrieve detailed information about a specific item by providing its unique Filmfaffinity URL as a parameter. This endpoint is designed to streamline the retrieval of item data from a larger dataset, facilitating quick access to attributes such as title, description, price, availability, and others...

Endpoint ID: 24799
GET https://api-sneakers-database.zylalabs.com/api/12716/filmaffinity+api+data/24799/item-by-url
INPUT PARAMETERS

Item-by-URL — Endpoint Features

Object Description
url Required FilmAffinity URL (ex: *https://www.filmaffinity.com/es/film932476.html* )
lang Optional Select only one: *es* (spanish) or *en* (english)
cache_bd Optional Select: Speed-optimized (**true**) or Freshness-optimized (**false**)

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

url
lang
cache_bd
API EXAMPLE RESPONSE
JSON
{"id":932476,"type":"movie","title":{"original":"The Matrix","local":"Matrix"},"year":1999,"duration_minutes":131,"countries":["Estados Unidos"],"languages":[],"genres":["Ciencia ficción","Fantástico","Acción","Thriller","Thriller futurista","Mundo virtual","Cyberpunk","Distopía","Internet / Informática","Artes marciales","Película de culto"],"synopsis":"Thomas Anderson es un brillante programador de una respetable compañía de software. Pero fuera del trabajo es Neo, un hacker que un día recibe una misteriosa visita... (FILMAFFINITY)","rating":7.9,"votes":199763,"poster_url":"https://pics.filmaffinity.com/the_matrix-155050517-mmed.jpg","fa_url":"https://www.filmaffinity.com/es/film932476.html","credits":{"directors":["Lilly Wachowski","Lana Wachowski","Hermanas Wachowski"],"writers":["Lilly Wachowski","Lana Wachowski"],"cast":[{"name":"Keanu Reeves","character":null,"photo_url":"https://pics.filmaffinity.com/keanu_reeves-249385740937163-nm_200.jpg"},{"name":"Laurence Fishburne","character":null,"photo_url":"https://pics.filmaffinity.com/laurence_fishburne-070287699861199-nm_200.jpg"},{"name":"Carrie-Anne Moss","character":null,"photo_url":"https://pics.filmaffinity.com/carrie_anne_moss-204191028328099-nm_200.jpg"},{"name":"Joe Pantoliano","character":null,"photo_url":"https://pics.filmaffinity.com/joe_pantoliano-165515591455445-nm_200.jpg"},{"name":"Hugo Weaving","character":null,"photo_url":"https://pics.filmaffinity.com/hugo_weaving-031348611626736-nm_200.jpg"},{"name":"Marcus Chong","character":null,"photo_url":"https://pics.filmaffinity.com/marcus_chong-050984070190899-nm_200.jpg"},{"name":"Gloria Foster","character":null,"photo_url":"https://pics.filmaffinity.com/gloria_foster-029526648398964-nm_200.jpg"},{"name":"Matt Doran","character":null,"photo_url":"https://pics.filmaffinity.com/matt_doran-017655586129192-nm_200.jpg"},{"name":"Belinda McClory","character":null,"photo_url":"https://pics.filmaffinity.com/belinda_mcclory-188757579700012-nm_200.jpg"},{"name":"Julian Arahanga","character":null,"photo_url":"https://pics.filmaffinity.com/julian_arahanga-114303540482099-nm_200.jpg"},{"name":"Anthony Ray Parker","character":null,"photo_url":"https://pics.filmaffinity.com/anthony_ray_parker-020562095453699-nm_200.jpg"},{"name":"Paul Goddard","character":null,"photo_url":"https://pics.filmaffinity.com/paul_goddard-080003031603806-nm_200.jpg"},{"name":"Robert Taylor","character":null,"photo_url":"https://pics.filmaffinity.com/robert_taylor-261000528344137-nm_200.jpg"}],"music":["Don Davis"],"photography":["Bill Pope"],"producers":[],"other":[]},"companies":{"production":["Warner Bros.","Village Roadshow","Groucho Film Partnership","Silver Pictures","3 Arts Entertainment","Joel Silver"],"distribution":[]},"reviews":[{"text":"Un programador pirata recibe un día una misteriosa visita... Nada más se debe contar de la sinopsis de Matrix. Es más, si todavía no la ha visto, no deje que nadie le cuente qué es Matrix. Porque gran parte del éxito mundial de esta fascinante y entretenidísima película se basa en su original guion, asombrosa idea y producto de la era tecnológica en la que vivimos. Si a ello le unimos su revolucionaria estética -con espectaculares y trepidantes escenas de acción nunca vistas en el género-, tendremos el porqué de la consagración de esta cinta fantástica como el mayor film de culto de final de siglo. Puede que en unos años quede obsoleta, pero para entonces ya nada nos hará olvidar el día que descubrimos qué es Matrix... y a aquella Trinity | Carrie-Anne Moss, auténtico hielo -que de frío quema-, la más hipnótica heroína de estos tiempos cibernéticos.","author":"Pablo Kurt","publication":"FilmAffinity","sentiment":"pos"},{"text":"\"Lo que importa aquí es la forma y el ritmo\"","author":"Omar Khan","publication":"Cinemanía","sentiment":"pos"},{"text":"\"Deslumbra y es un gran espectáculo digno de ser visto, pero se pierde un poco dentro de un pretencioso eclecticismo\"","author":"Jesús Ruiz Mantilla","publication":"Diario El País","sentiment":"pos"},{"text":"\"No es solo una excelente película de ciencia-ficción: es uno de esos saltos evolutivos que, de tanto en tanto, propulsan al género hacia inéditos hiperespacios del espectáculo. (…) Puntuación: ★★★ (sobre 5)\"","author":"Jordi Costa","publication":"Fotogramas","sentiment":"pos"},{"text":"\"Sin duda, la más fascinante entrega de ciencia-ficción que se ha dado en el cine mundial en los últimos años. Espectaculares efectos especiales para una cinta que se separa totalmente de todo lo visto hasta el momento\"","author":"Fernando Morales","publication":"Diario El País","sentiment":"pos"},{"text":"\"La estética super cool que verdaderamente aporta algo nuevo al léxico de la ciencia ficción, convierte a este thriller de saltos temporales en una cita obligatoria para fans del género\"","author":"Todd McCarthy","publication":"Variety","sentiment":"pos"},{"text":"\"'The Matrix' recicla las premisas de 'Dark City' y 'Días extraños', sube el volumen y la intensidad y toma prestada la coreografía aérea de las películas de acción hongkonesas. Es entretenida, pero podría haber sido mucho más (...) Puntuación: ★★★ (sobre 4)\"","author":"Roger Ebert","publication":"Chicago Sun-Times","sentiment":"pos"}],"aka":[],"groups":["Matrix"],"awards":[{"year":1999,"text":"4 Oscars: Mejor montaje, sonido, efectos visuales, efectos sonoros"},{"year":1999,"text":"2 Premios BAFTA: Mejores efectos visuales y sonido. 5 nominaciones"},{"year":1999,"text":"Sindicato de Productores (PGA): Nominada a Mejor película"},{"year":1999,"text":"Saturn Awards: 2 premios. 9 nominaciones"},{"year":2000,"text":"Premios Image: 2 nominaciones"}],"professional_reviews_summary":{"average":17.0,"positive":16,"neutral":0,"negative":1,"total":17},"relations":[{"type":"tiene secuela","id":349820,"title":"Matrix Reloaded","fa_url":"https://www.filmaffinity.com/es/film349820.html","poster_url":"https://pics.filmaffinity.com/the_matrix_reloaded-133935821-msmall.jpg"},{"type":"documental asociado","id":302605,"title":"Generación Matrix","fa_url":"https://www.filmaffinity.com/es/film302605.html","poster_url":"https://pics.filmaffinity.com/matrix_generation-228019227-msmall.jpg"}],"streaming":[{"type":"subscription","providers":["Amazon Prime Video","HBO Max","Movistar Plus+ Ficción Total ","Movistar Plus+","HBO Max Amazon Channel","Amazon Prime Video with Ads"]},{"type":"rental","providers":["Google Play Movies","Apple TV Store","Rakuten TV","Amazon Video"]},{"type":"purchase","providers":["Google Play Movies","Apple TV Store","Rakuten TV","Amazon Video"]}],"user_reviews_count":427,"lang":"es","cached":true,"scraped_at":"2026-06-03T15:36:17.244298"}
Item-by-URL — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/12716/filmaffinity+api+data/24799/item-by-url?url=https://www.filmaffinity.com/es/film932476.html&lang=es&cache_bd=true' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

GET /v1/item by ID endpoint allows clients to retrieve detailed information about a specific item by providing its unique Filmfaffinity URL as a parameter. This endpoint is designed to streamline the retrieval of item data from a larger dataset, facilitating quick access to attributes such as title, description, price, availability, and others.

Endpoint ID: 24815
GET https://api-sneakers-database.zylalabs.com/api/12716/filmaffinity+api+data/24815/item-by-id
INPUT PARAMETERS

Item-by-ID — Endpoint Features

Object Description
item_id Required FilmAffinity ID (ex: filmaffinity.com/es/film932476.html )
lang Required Select only one: es (spanish) or en (english)
cache_bd Required Select: Speed-optimized (true) or Freshness-optimized (false)

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

item_id
lang
cache_bd
API EXAMPLE RESPONSE
JSON
{"id":932476,"type":"movie","title":{"original":"The Matrix","local":"Matrix"},"year":1999,"duration_minutes":131,"countries":["Estados Unidos"],"languages":[],"genres":["Ciencia ficción","Fantástico","Acción","Thriller","Thriller futurista","Mundo virtual","Cyberpunk","Distopía","Internet / Informática","Artes marciales","Película de culto"],"synopsis":"Thomas Anderson es un brillante programador de una respetable compañía de software. Pero fuera del trabajo es Neo, un hacker que un día recibe una misteriosa visita... (FILMAFFINITY)","rating":7.9,"votes":199763,"poster_url":"https://pics.filmaffinity.com/the_matrix-155050517-mmed.jpg","fa_url":"https://www.filmaffinity.com/es/film932476.html","credits":{"directors":["Lilly Wachowski","Lana Wachowski","Hermanas Wachowski"],"writers":["Lilly Wachowski","Lana Wachowski"],"cast":[{"name":"Keanu Reeves","character":null,"photo_url":"https://pics.filmaffinity.com/keanu_reeves-249385740937163-nm_200.jpg"},{"name":"Laurence Fishburne","character":null,"photo_url":"https://pics.filmaffinity.com/laurence_fishburne-070287699861199-nm_200.jpg"},{"name":"Carrie-Anne Moss","character":null,"photo_url":"https://pics.filmaffinity.com/carrie_anne_moss-204191028328099-nm_200.jpg"},{"name":"Joe Pantoliano","character":null,"photo_url":"https://pics.filmaffinity.com/joe_pantoliano-165515591455445-nm_200.jpg"},{"name":"Hugo Weaving","character":null,"photo_url":"https://pics.filmaffinity.com/hugo_weaving-031348611626736-nm_200.jpg"},{"name":"Marcus Chong","character":null,"photo_url":"https://pics.filmaffinity.com/marcus_chong-050984070190899-nm_200.jpg"},{"name":"Gloria Foster","character":null,"photo_url":"https://pics.filmaffinity.com/gloria_foster-029526648398964-nm_200.jpg"},{"name":"Matt Doran","character":null,"photo_url":"https://pics.filmaffinity.com/matt_doran-017655586129192-nm_200.jpg"},{"name":"Belinda McClory","character":null,"photo_url":"https://pics.filmaffinity.com/belinda_mcclory-188757579700012-nm_200.jpg"},{"name":"Julian Arahanga","character":null,"photo_url":"https://pics.filmaffinity.com/julian_arahanga-114303540482099-nm_200.jpg"},{"name":"Anthony Ray Parker","character":null,"photo_url":"https://pics.filmaffinity.com/anthony_ray_parker-020562095453699-nm_200.jpg"},{"name":"Paul Goddard","character":null,"photo_url":"https://pics.filmaffinity.com/paul_goddard-080003031603806-nm_200.jpg"},{"name":"Robert Taylor","character":null,"photo_url":"https://pics.filmaffinity.com/robert_taylor-261000528344137-nm_200.jpg"}],"music":["Don Davis"],"photography":["Bill Pope"],"producers":[],"other":[]},"companies":{"production":["Warner Bros.","Village Roadshow","Groucho Film Partnership","Silver Pictures","3 Arts Entertainment","Joel Silver"],"distribution":[]},"reviews":[{"text":"Un programador pirata recibe un día una misteriosa visita... Nada más se debe contar de la sinopsis de Matrix. Es más, si todavía no la ha visto, no deje que nadie le cuente qué es Matrix. Porque gran parte del éxito mundial de esta fascinante y entretenidísima película se basa en su original guion, asombrosa idea y producto de la era tecnológica en la que vivimos. Si a ello le unimos su revolucionaria estética -con espectaculares y trepidantes escenas de acción nunca vistas en el género-, tendremos el porqué de la consagración de esta cinta fantástica como el mayor film de culto de final de siglo. Puede que en unos años quede obsoleta, pero para entonces ya nada nos hará olvidar el día que descubrimos qué es Matrix... y a aquella Trinity | Carrie-Anne Moss, auténtico hielo -que de frío quema-, la más hipnótica heroína de estos tiempos cibernéticos.","author":"Pablo Kurt","publication":"FilmAffinity","sentiment":"pos"},{"text":"\"Lo que importa aquí es la forma y el ritmo\"","author":"Omar Khan","publication":"Cinemanía","sentiment":"pos"},{"text":"\"Deslumbra y es un gran espectáculo digno de ser visto, pero se pierde un poco dentro de un pretencioso eclecticismo\"","author":"Jesús Ruiz Mantilla","publication":"Diario El País","sentiment":"pos"},{"text":"\"No es solo una excelente película de ciencia-ficción: es uno de esos saltos evolutivos que, de tanto en tanto, propulsan al género hacia inéditos hiperespacios del espectáculo. (…) Puntuación: ★★★ (sobre 5)\"","author":"Jordi Costa","publication":"Fotogramas","sentiment":"pos"},{"text":"\"Sin duda, la más fascinante entrega de ciencia-ficción que se ha dado en el cine mundial en los últimos años. Espectaculares efectos especiales para una cinta que se separa totalmente de todo lo visto hasta el momento\"","author":"Fernando Morales","publication":"Diario El País","sentiment":"pos"},{"text":"\"La estética super cool que verdaderamente aporta algo nuevo al léxico de la ciencia ficción, convierte a este thriller de saltos temporales en una cita obligatoria para fans del género\"","author":"Todd McCarthy","publication":"Variety","sentiment":"pos"},{"text":"\"'The Matrix' recicla las premisas de 'Dark City' y 'Días extraños', sube el volumen y la intensidad y toma prestada la coreografía aérea de las películas de acción hongkonesas. Es entretenida, pero podría haber sido mucho más (...) Puntuación: ★★★ (sobre 4)\"","author":"Roger Ebert","publication":"Chicago Sun-Times","sentiment":"pos"}],"aka":[],"groups":["Matrix"],"awards":[{"year":1999,"text":"4 Oscars: Mejor montaje, sonido, efectos visuales, efectos sonoros"},{"year":1999,"text":"2 Premios BAFTA: Mejores efectos visuales y sonido. 5 nominaciones"},{"year":1999,"text":"Sindicato de Productores (PGA): Nominada a Mejor película"},{"year":1999,"text":"Saturn Awards: 2 premios. 9 nominaciones"},{"year":2000,"text":"Premios Image: 2 nominaciones"}],"professional_reviews_summary":{"average":17.0,"positive":16,"neutral":0,"negative":1,"total":17},"relations":[{"type":"tiene secuela","id":349820,"title":"Matrix Reloaded","fa_url":"https://www.filmaffinity.com/es/film349820.html","poster_url":"https://pics.filmaffinity.com/the_matrix_reloaded-133935821-msmall.jpg"},{"type":"documental asociado","id":302605,"title":"Generación Matrix","fa_url":"https://www.filmaffinity.com/es/film302605.html","poster_url":"https://pics.filmaffinity.com/matrix_generation-228019227-msmall.jpg"}],"streaming":[{"type":"subscription","providers":["Amazon Prime Video","HBO Max","Movistar Plus+ Ficción Total ","Movistar Plus+","HBO Max Amazon Channel","Amazon Prime Video with Ads"]},{"type":"rental","providers":["Google Play Movies","Apple TV Store","Rakuten TV","Amazon Video"]},{"type":"purchase","providers":["Google Play Movies","Apple TV Store","Rakuten TV","Amazon Video"]}],"user_reviews_count":427,"lang":"es","cached":true,"scraped_at":"2026-06-03T15:36:17.244298"}
Item-by-ID — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/12716/filmaffinity+api+data/24815/item-by-id?item_id=932476&lang=es&cache_bd=true' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

GET /v1/discover returns ranked FilmAffinity titles based on custom: category, genre, country, year, votes, duration, platform and language.

Endpoint ID: 24801
GET https://api-sneakers-database.zylalabs.com/api/12716/filmaffinity+api+data/24801/discover
INPUT PARAMETERS

Discover — Endpoint Features

Object Description
category Optional Select only one: all,movies,showstv,docs,shorts,animation,music
genre Optional Comma-separated choices: all | comedy,drama,adventure,fantasy, thriller....
country Optional Select only 1 country or region: spain,italy,united_states, anglo_saxon...
year_from Optional Minimum release year: 1874
year_to Optional Maximum release year: 1874 - Until now
min_votes Optional Minimum vote count: 20, 100, 500, 1000
duration_min Optional Minimum duration in minutes: 0, 20, 30, 45, 60, 90, 120, 1000 (+2h)
duration_max Optional Maximum duration in minutes: 0, 20, 30, 45, 60, 90, 120, 1000 (+2h)
platform Optional Streaming platform: all | netflix, amazon, disney...
lang Optional Select only one: es (spanish) or en (english)
limit_results Optional Limit results: 1–1000; 30 by default
cache_bd Optional Select: Speed-optimized (true) or Freshness-optimized (false)

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

category
genre
country
year_from
year_to
min_votes
duration_min
duration_max
platform
lang
limit_results
cache_bd
API EXAMPLE RESPONSE
JSON
{"lang":"es","filters":{"category":"all","year_from":1874,"year_to":2026,"min_votes":500,"duration_min":0,"duration_max":1000},"count":30,"results":[{"id":809297,"title":"El padrino","year":1972,"rating":9.0,"poster_url":"https://pics.filmaffinity.com/the_godfather-488102675-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film809297.html"},{"id":107937,"title":"Planeta Tierra II","year":2016,"rating":8.9,"poster_url":"https://pics.filmaffinity.com/planet_earth_ii-875634466-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film107937.html"},{"id":730528,"title":"El padrino. Parte II","year":1974,"rating":8.9,"poster_url":"https://pics.filmaffinity.com/the_godfather_part_ii-617901053-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film730528.html"},{"id":399474,"title":"The Wire (Bajo escucha)","year":2002,"rating":8.8,"poster_url":"https://pics.filmaffinity.com/the_wire-680717276-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film399474.html"},{"id":489970,"title":"Breaking Bad","year":2008,"rating":8.8,"poster_url":"https://pics.filmaffinity.com/breaking_bad-504442815-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film489970.html"},{"id":601451,"title":"Cosmos","year":1980,"rating":8.8,"poster_url":"https://pics.filmaffinity.com/cosmos-224838468-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film601451.html"},{"id":518489,"title":"Planeta azul II","year":2017,"rating":8.7,"poster_url":"https://pics.filmaffinity.com/blue_planet_ii-415010287-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film518489.html"},{"id":695552,"title":"Doce hombres sin piedad","year":1957,"rating":8.7,"poster_url":"https://pics.filmaffinity.com/12_angry_men-122099105-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film695552.html"},{"id":191501,"title":"Kill Bill: The Whole Bloody Affair","year":2004,"rating":8.7,"poster_url":"https://pics.filmaffinity.com/kill_bill_the_whole_bloody_affair-455135213-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film191501.html"},{"id":661074,"title":"Cosmos: A Space-Time Odyssey","year":2014,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/cosmos_a_space_time_odyssey-358329014-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film661074.html"},{"id":656153,"title":"La lista de Schindler","year":1993,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/schindler_s_list-473662617-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film656153.html"},{"id":667376,"title":"Testigo de cargo","year":1957,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/witness_for_the_prosecution-236651370-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film667376.html"},{"id":161026,"title":"Cadena perpetua","year":1994,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/the_shawshank_redemption-576140557-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film161026.html"},{"id":221477,"title":"Apocalipsis: La Segunda Guerra Mundial","year":2009,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/apocalypse_la_2eme_guerre_mondiale_apocalypse_the_second_world_war-890588232-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film221477.html"},{"id":750301,"title":"Luces de la ciudad","year":1931,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/city_lights-825971402-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film750301.html"},{"id":372160,"title":"Los Simpson","year":1989,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/the_simpsons-397676780-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film372160.html"},{"id":155010,"title":"El gran dictador","year":1940,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/the_great_dictator-416205081-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film155010.html"},{"id":160882,"title":"Pulp Fiction","year":1994,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/pulp_fiction-210382116-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film160882.html"},{"id":726746,"title":"Tiempos modernos","year":1936,"rating":8.6,"poster_url":"https://pics.filmaffinity.com/modern_times-287431985-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film726746.html"},{"id":934135,"title":"Planeta Tierra","year":2006,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/planet_earth-535384921-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film934135.html"},{"id":402150,"title":"Los Soprano","year":1999,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/the_sopranos-196243243-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film402150.html"},{"id":385464,"title":"El golpe","year":1973,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/the_sting-433653100-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film385464.html"},{"id":874956,"title":"Juego de Tronos","year":2011,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/game_of_thrones-293142110-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film874956.html"},{"id":640188,"title":"Hermanos de sangre","year":2001,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/band_of_brothers-541225951-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film640188.html"},{"id":684718,"title":"Ser o no ser","year":1942,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/to_be_or_not_to_be-104389643-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film684718.html"},{"id":356260,"title":"Siete mundos, un planeta","year":2019,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/seven_worlds_one_planet-583888125-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film356260.html"},{"id":883966,"title":"The Beatles Anthology","year":1995,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/the_beatles_anthology-574798977-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film883966.html"},{"id":209631,"title":"Harakiri","year":1962,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/seppuku_harakiri-539847961-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film209631.html"},{"id":536488,"title":"El crepúsculo de los dioses","year":1950,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/sunset_blvd_sunset_boulevard-317106274-msmall.jpg","type":"movie","fa_url":"https://www.filmaffinity.com/es/film536488.html"},{"id":594480,"title":"La vida es bella","year":1997,"rating":8.5,"poster_url":"https://pics.filmaffinity.com/la_vita_e_bella-646167341-msmall.jpg","type":"series","fa_url":"https://www.filmaffinity.com/es/film594480.html"}],"cached":true,"warming":false,"retry_after":null,"message":null}
Discover — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/12716/filmaffinity+api+data/24801/discover?category=all' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Filmaffinity API Data simply include your bearer token in the Authorization header.

Headers
Header Description
Authorization Required Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

(Save 2 months with annual billing 🎉)

🚀 Enterprise Plan

Starts at
$ 10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring

Overview

 

Filmaffinity API Data Overview

Effortlessly extract and structure rich FilmAffinity data through our powerful and user-friendly API endpoints:

  • GET /v1/search: Conduct a text-based search for film and TV titles.
  • GET /v1/item: Retrieve detailed information for movies or TV shows using their unique Filmaffinity item_id or URL.
  • GET /v1/discover: Access custom listings by utilizing advanced filtering options, including category, genre, country, year range, minimum votes, duration limits, platform, language, and result limitations.

Key Features

  • Consistent and integration-friendly JSON responses for seamless development.
  • A robust caching layer that enhances latency and ensures stable performance.
  • Configurable cache_bd parameter on every endpoint for optimized speed (default: true) or up-to-date data (false).
  • Resilient backend technology equipped with automated fallbacks and advanced AI mechanisms.
  • Supports both Spanish (lang=es) and English (lang=en) languages for broader accessibility.
  • Ideal for applications, dashboards, bots, and automation purposes.
  • Adaptive HTML extraction powered by AI to gracefully handle various HTML changes.

Additional Information

Ensure you specify lang=es (default) or lang=en on all endpoints for language preferences. For the discover endpoint, please refer to the documented slugs for genres and countries. It is advisable to implement soft retries in cases where responses indicate warming or a need to retry.

Optimized Performance Through Caching

Responses can either be served from our persistent cache or refreshed as demanded, ensuring optimal performance.

Standard Refresh Rates (TTL):

  • Item Details: Cached for 7 days
  • Search Results: Cached for 48 hours
  • Discover Listings: Cached for 48 hours

Configuring Cache Behavior

The cache_bd query parameter is available on all endpoints:

  • true (default): Use stored data when available (no expiry on read). On a cache miss, the API fetches and stores the result. Best for fast, stable integrations; lower extraction usage.
  • false: Always fetch fresh data on each request and update the store (a later true request can reuse it. Best for when you need the latest FilmAffinity data

Responses will include a cached indicator (true if the payload was retrieved from cache). If data is still being prepared, you may receive a warming response, indicating true and retry_after, suggesting a delay before resubmission of the same request.

Tip: Using cache_bd=true is recommended for scenarios prioritizing speed and stability, while employing cache_bd=false is advisable only when real-time data is essential (expect higher latency).

API Reference and Examples

Comprehensive documentation related to each API endpoint is available:

  • GET /v1/search: Conduct a concise text search (returns approximately 50 results)
  • GET /v1/item/by-id: Fetch complete item details using the numeric ID
  • GET /v1/item?url=: Access full item details via the FilmAffinity URL
  • GET /v1/discover: Obtain custom FilmAffinity listings (available with payment plan only)

 

Filmaffinity API Data FAQs

Each endpoint returns structured data in JSON format. The `/v1/search` endpoint provides a list of titles with details like title, year, rating, and poster. The `/v1/item` endpoints return comprehensive item details, including synopsis, genres, cast, and more. The `/v1/discover` endpoint offers ranked titles based on various filters, including category and genre.

Key fields include `id`, `title`, `year`, `rating`, `poster_url`, and `fa_url` for search results. For item details, additional fields like `duration_minutes`, `countries`, `languages`, `genres`, and `synopsis` are included. The discover endpoint also features `filters` and `count`.

Users can customize requests by using query parameters such as `search` for the search endpoint, `url` or `id` for item details, and various filters like `category`, `genre`, and `year` for the discover endpoint. The `cache_bd` parameter allows control over caching behavior.

Response data is organized in a structured JSON format. Each endpoint returns a root object containing relevant fields. For example, the search response includes a `results` array with individual title objects, while the item response provides a detailed object with attributes like `credits` and `synopsis`.

The data is sourced from FilmAffinity, a film and TV database. The API aggregates and structures this data for easy access. Data accuracy is maintained through regular updates and a robust backend technology that includes automated fallbacks.

Typical use cases include building applications for film discovery, creating dashboards for movie analytics, developing bots for automated recommendations, and integrating film data into existing platforms for enhanced user experiences.

Users can utilize the returned data by parsing the JSON response to extract relevant fields for display or analysis. For instance, developers can use the `poster_url` to show images, `rating` for sorting, and `synopsis` for providing summaries in their applications.

If a request returns partial or empty results, users should check the `count` field in the response to understand the number of results found. Implementing error handling for cases where no data is returned can improve user experience, such as displaying a message indicating no matches were found.

General FAQs

To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.

You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.

The free trial lasts for 7 days and allows you to make up to 50 API requests.

No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.

Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

You can monitor your API usage through the response headers included with every request:

x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.

Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund


Related APIs