Dados da API do Filmaffinity API

API ID 12716

API FilmAffinity para pesquisar títulos descobrir conteúdo com filtros avançados e recuperar dados detalhados de itens em JSON Idiomas suportados: Espanhol e Inglês Não afiliado ao FilmAffinity

100% uptime 1,061 ms resp. média

Documentação da API

Endpoints

Requisição

GET /v1/search permite que os usuários encontrem filmes e títulos de TV no FilmAffinity usando uma consulta de texto. Envie search e obtenha resultados estruturados com título, ano, tipo, pôster e outros... Opcional cache_bd controla se o cache do banco de dados é lido/atualizado.

Endpoint ID: 24798
GET https://docs.zylalabs.com/api/12716/filmaffinity+api+data/24798/search
PARÂMETROS DE ENTRADA

Pesquisar — Recursos do endpoint

Objeto Descrição
search Obrigatório Search query: spiderman, breaking bad, Braveheart...
lang Opcional Select only one: es (spanish) or en (english)
cache_bd Opcional Select: Speed-optimized (true) or Freshness-optimized (false)

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

search
lang
cache_bd
RESPOSTA DE EXEMPLO DA API
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}
Pesquisar — TRECHOS DE CÓDIGO

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' 


    
Requisição

GET /v1/item por URL o endpoint permite que os clientes recuperem informações detalhadas sobre um item específico fornecendo sua URL única do Filmfaffinity como um parâmetro. Este endpoint é projetado para simplificar a recuperação de dados do item de um conjunto de dados maior, facilitando o acesso rápido a atributos como título, descrição, preço, disponibilidade e outros...

Endpoint ID: 24799
GET https://docs.zylalabs.com/api/12716/filmaffinity+api+data/24799/item-by-url
PARÂMETROS DE ENTRADA

Item-por-URL — Recursos do endpoint

Objeto Descrição
url Obrigatório FilmAffinity URL (ex: *https://www.filmaffinity.com/es/film932476.html* )
lang Opcional Select only one: *es* (spanish) or *en* (english)
cache_bd Opcional Select: Speed-optimized (**true**) or Freshness-optimized (**false**)

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

url
lang
cache_bd
RESPOSTA DE EXEMPLO DA API
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-por-URL — TRECHOS DE CÓDIGO

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' 


    
Requisição

GET /v1/item por ID o endpoint permite que os clientes recuperem informações detalhadas sobre um item específico fornecendo sua URL única do Filmfaffinity como parâmetro. Este endpoint é projetado para otimizar a recuperação de dados do item de um conjunto de dados maior, facilitando o acesso rápido a atributos como título, descrição, preço, disponibilidade e outros

Endpoint ID: 24815
GET https://docs.zylalabs.com/api/12716/filmaffinity+api+data/24815/item-by-id
PARÂMETROS DE ENTRADA

Item-por-ID — Recursos do endpoint

Objeto Descrição
item_id Obrigatório FilmAffinity ID (ex: filmaffinity.com/es/film932476.html )
lang Obrigatório Select only one: es (spanish) or en (english)
cache_bd Obrigatório Select: Speed-optimized (true) or Freshness-optimized (false)

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

item_id
lang
cache_bd
RESPOSTA DE EXEMPLO DA API
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-por-ID — TRECHOS DE CÓDIGO

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' 


    
Requisição

GET /v1/discover retorna títulos FilmAffinity classificados com base em: categoria, gênero, país, ano, votos, duração, plataforma e idioma.

Endpoint ID: 24801
GET https://docs.zylalabs.com/api/12716/filmaffinity+api+data/24801/discover
PARÂMETROS DE ENTRADA

Descubra — Recursos do endpoint

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

Solicitações gratuitas de teste restantes: 3 de 3.


PARÂMETROS DE ENTRADA

category
genre
country
year_from
year_to
min_votes
duration_min
duration_max
platform
lang
limit_results
cache_bd
RESPOSTA DE EXEMPLO DA API
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}
Descubra — TRECHOS DE CÓDIGO

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


    

Chave de acesso à API e autenticação

Após se cadastrar, cada desenvolvedor recebe uma chave de acesso à API pessoal, uma combinação única de letras e dígitos para acessar nosso endpoint de API. Para autenticar com a Dados da API do Filmaffinity API basta incluir seu token Bearer no cabeçalho Authorization.

Cabeçalhos
Cabeçalho Descrição
Authorization Obrigatório Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito.

Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.

(Economize 2 meses com cobrança anual 🎉)

🚀 Plano Empresarial

A partir de
$ 10.000/Ano


  • Volume personalizado
  • Limite de taxa personalizado
  • Suporte ao cliente especializado
  • Monitoramento de API em tempo real

Visão Geral

 

Visão Geral dos Dados da API Filmaffinity

Extraia e estruture facilmente dados ricos do FilmAffinity através de nossos poderosos e amigáveis endpoints da API:

  • GET /v1/search: Realize uma busca baseada em texto por filmes e títulos de TV.
  • GET /v1/item: Recupere informações detalhadas sobre filmes ou programas de TV utilizando seu item_id ou URL única do Filmaffinity.
  • GET /v1/discover: Acesse listas personalizadas utilizando opções de filtragem avançadas, incluindo categoria, gênero, país, faixa de ano, votos mínimos, limites de duração, plataforma, idioma e limitações de resultados.

Recursos Principais

  • Respostas JSON consistentes e amigáveis para integração para um desenvolvimento sem costura.
  • Uma camada de cache robusta que melhora a latência e garante desempenho estável.
  • Parâmetro cache_bd configurável em todos os endpoints para velocidade otimizada (padrão: true) ou dados atualizados (false).
  • Tecnologia de backend resiliente equipada com fallback automatizado e mecanismos avançados de IA.
  • Suporta tanto os idiomas espanhol (lang=es) quanto inglês (lang=en) para maior acessibilidade.
  • Ideal para aplicativos, dashboards, bots e fins de automação.
  • Extração HTML adaptativa alimentada por IA para lidar elegantemente com várias alterações de HTML.

Informações Adicionais

Assegure-se de especificar lang=es (padrão) ou lang=en em todos os endpoints para preferências de idioma. Para o endpoint discover, consulte os slugs documentados para gêneros e países. É aconselhável implementar tentativas suaves em casos onde as respostas indicam que o aquecimento ou a necessidade de re-tentar.

Desempenho Otimizado Através de Cache

As respostas podem ser servidas a partir do nosso cache persistente ou atualizadas conforme necessário, garantindo desempenho ideal.

Taxas de Atualização Padrão (TTL):

  • Detalhes do Item: Cacheado por 7 dias
  • Resultados da Pesquisa: Cacheado por 48 horas
  • Listagens Descobertas: Cacheado por 48 horas

Configurando o Comportamento do Cache

O parâmetro de consulta cache_bd está disponível em todos os endpoints:

  • true (padrão): Use dados armazenados quando disponíveis (sem expiração na leitura). Em caso de falta de cache, a API busca e armazena o resultado. Melhor para integrações rápidas e estáveis; menor uso de extração.
  • false: Sempre busque dados frescos em cada solicitação e atualize o armazenamento (uma solicitação true posterior pode reutilizá-lo. Melhor para quando você precisa dos dados mais recentes do FilmAffinity

As respostas incluirão um indicador cached (verdadeiro se a carga útil foi recuperada do cache). Se os dados ainda estiverem sendo preparados, você pode receber uma resposta warming, indicando true e retry_after, sugerindo um atraso antes da reapresentação da mesma solicitação.

Dica: Usar cache_bd=true é recomendado para cenários que priorizam velocidade e estabilidade, enquanto empregar cache_bd=false é aconselhável apenas quando dados em tempo real são essenciais (espere maior latência).

Referência da API e Exemplos

Documentação abrangente relacionada a cada endpoint da API está disponível:

  • GET /v1/search: Realize uma busca textual concisa (retorna aproximadamente 50 resultados)
  • GET /v1/item/by-id: Busque detalhes completos do item usando o ID numérico
  • GET /v1/item?url=: Acesse detalhes completos do item através da URL do FilmAffinity
  • GET /v1/discover: Obtenha listagens personalizadas do FilmAffinity (disponível apenas com plano de pagamento)

 

Dados da API do Filmaffinity API FAQs

Cada endpoint retorna dados estruturados no formato JSON O endpoint `/v1/search` fornece uma lista de títulos com detalhes como título ano classificação e pôster O endpoint `/v1/item` retorna detalhes completos do item incluindo sinopse gêneros elenco e mais O endpoint `/v1/discover` oferece títulos classificados com base em vários filtros incluindo categoria e gênero

Os campos principais incluem `id`, `título`, `ano`, `avaliação`, `url_cartaz` e `url_fa` para os resultados da busca. Para detalhes do item, campos adicionais como `duração_minutos`, `países`, `idiomas`, `gêneros` e `sinopse` estão incluídos. O endpoint de descoberta também apresenta `filtros` e `contagem`

Os usuários podem personalizar solicitações usando parâmetros de consulta como `search` para o endpoint de busca, `url` ou `id` para detalhes do item, e vários filtros como `category`, `genre` e `year` para o endpoint de descoberta. O parâmetro `cache_bd` permite o controle sobre o comportamento de cache

Os dados da resposta estão organizados em um formato JSON estruturado Cada endpoint retorna um objeto raiz contendo campos relevantes Por exemplo a resposta de busca inclui um array de `resultados` com objetos de título individuais enquanto a resposta do item fornece um objeto detalhado com atributos como `créditos` e `sinopse`

Os dados são originados do FilmAffinity uma base de dados de filmes e TV A API agrega e estrutura esses dados para fácil acesso A precisão dos dados é mantida por meio de atualizações regulares e uma tecnologia de backend robusta que inclui backups automáticos

Casos de uso típicos incluem a construção de aplicativos para descoberta de filmes a criação de painéis para análise de filmes o desenvolvimento de bots para recomendações automatizadas e a integração de dados de filmes em plataformas existentes para aprimorar a experiência do usuário

Os usuários podem utilizar os dados retornados analisando a resposta JSON para extrair campos relevantes para exibição ou análise Por exemplo desenvolvedores podem usar o `poster_url` para mostrar imagens `rating` para ordenar e `synopsis` para fornecer resumos em suas aplicações

Se um pedido retornar resultados parciais ou vazios os usuários devem verificar o campo `count` na resposta para entender o número de resultados encontrados Implementar o tratamento de erros para casos em que nenhum dado é retornado pode melhorar a experiência do usuário como exibir uma mensagem indicando que nenhuma correspondência foi encontrada

Perguntas Frequentes Gerais

O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]

Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]

APIs relacionadas


Você também pode gostar