Marketplace
No threads yet
Live

get_filmography_by_name

filmaffinity.com

Returns role-filtered filmography records for a person found by name search on https://filmaffinity.com, with advanced-search fallback and complete movie metadata.

Parameters3
Runs10
Updated3d ago
Degraded10 runs · 80% succeeded
30 days agotoday

Playground

Runs on Notte and spends your workspace credits — what comes back is the live response, not a sample.

What is get_filmography_by_name?

Returns role-filtered filmography records for a person found by name search on https://filmaffinity.com, with advanced-search fallback and complete movie metadata. It runs on Notte's browser infrastructure and returns structured JSON, so you can call it like any other API — pass person_name, role, page and get the result back without maintaining a scraper.

Response

{
  "role": "<string>",
  "count": 0,
  "films": [
    {
      "year": 0,
      "title": "<string>",
      "votes": 0,
      "rating": 0,
      "country": "<string>",
      "film_id": "<string>",
      "film_url": "<string>",
      "directors": [
        {
          "name": "<string>",
          "person_id": "<string>",
          "person_url": "<string>"
        }
      ],
      "poster_url": "<string>",
      "media_types": [
        "<string>"
      ],
      "cast_context": "<string>",
      "cast_preview": [
        {
          "name": "<string>",
          "person_id": "<string>",
          "person_url": "<string>"
        }
      ],
      "country_code": "<string>",
      "cast_preview_truncated": true
    }
  ],
  "query": "<string>",
  "complete": true,
  "person_id": "<string>",
  "role_code": "<string>",
  "person_url": "<string>",
  "person_name": "<string>",
  "total_pages": 0,
  "pages_fetched": 0,
  "search_method": "<string>",
  "available_roles": [
    "<string>"
  ]
}

Call it

curl --location 'https://us-prod.notte.cc/functions/fd033ca8-4df3-4216-85f7-8630e14b9362/runs/start' \
--header 'x-notte-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data '{
    "function_id": "fd033ca8-4df3-4216-85f7-8630e14b9362",
    "variables": {
        "person_name": "Keanu Reeves",
        "role": "actor",
        "page": 1
    }
}'

Ask an agent

Paste this into Claude Code, Cursor or any MCP client to have an agent call this function for you.

prompt
Use the Anything API MCP server (https://anything.notte.cc/mcp).

Call run(function_id="fd033ca8-4df3-4216-85f7-8630e14b9362") — the "get_filmography_by_name" function, which returns role-filtered filmography records for a person found by name search on https://filmaffinity.com, with advanced-search fallback and complete movie metadata..

It takes person_name (str), role (str), page (int). Return the result as structured JSON.