# Agent Data API

> Pay-per-call data APIs for AI agents: SEO data (keywords, SERP, competitors, search intent, AI-search demand) and, in a separate category, social media content planning for agencies and video teams (content month plan with linked dates, re-scheduling, shoot-day planning, shot lists, location check). Each call costs a small USDC amount paid with the x402 protocol. No account, no API key.

## Task guides (free to read; no payment authority)
- Worked content example (offline snapshot, no payment proof): https://agent.chiemgaufilms.com/content-planning-example (German: /de/content-planung-beispiel); inputs and date-only results: https://agent.chiemgaufilms.com/examples/content-case-study.json. The shift example has conflicts; do not apply it blindly.
- Website keyword demand: https://agent.chiemgaufilms.com/keyword-research (German: /de/keyword-recherche)
- Local search visibility: https://agent.chiemgaufilms.com/local-visibility (German: /de/lokale-sichtbarkeit)
- Content month with linked dates: https://agent.chiemgaufilms.com/content-planning (German: /de/content-planung)
- Each guide includes an illustrative result and a bounded agent task. Check live availability and price, validate input and obtain explicit purchase approval.

## How to use
- MCP client setup (Codex, Claude Code, Cursor): https://agent.chiemgaufilms.com/connect (German: /de/einrichten)
- Free MCP connection check script (no wallet or payment code): https://agent.chiemgaufilms.com/examples/mcp-check.mjs; calls only tools/list, list_services and preflight.
- REST and MCP purchase guide: https://agent.chiemgaufilms.com/quickstart.html
- Downloadable buyer example (free preview by default): https://agent.chiemgaufilms.com/examples/buyer.mjs
- Free catalog with prices and limits: https://agent.chiemgaufilms.com/api/v1/services
- OpenAPI 3.1 (with x402 price metadata): https://agent.chiemgaufilms.com/openapi.json
- MCP server (Streamable HTTP): https://agent.chiemgaufilms.com/mcp
- Free samples (if enabled, see /api/v1/services "free_sample"): POST https://agent.chiemgaufilms.com/api/v1/free-sample/{service-id} with the same JSON body as the paid route, one per service per client per day, for single-call services up to 0.05 USDC; limited daily total. Legacy: POST https://agent.chiemgaufilms.com/api/v1/free-sample with {"keyword":"..."} (keyword-metrics, one keyword).
- Locations (free): GET https://agent.chiemgaufilms.com/api/v1/locations?q=rosenheim (city/region codes in Germany, Austria, Switzerland for google-serp, local-business, news-search, image-search, local-market-check; MCP tool "find_location"). Other services take country codes (2276, 2040, 2756).
- Wishlist (free, write-only): POST https://agent.chiemgaufilms.com/api/v1/wishlist with {"text":"which data tool you would pay for"}, 10 to 300 characters, 3 per day per client; MCP tool "wishlist".
- Task recipes (free, machine-readable): https://agent.chiemgaufilms.com/recipes.json
- Agent card: https://agent.chiemgaufilms.com/.well-known/agent.json · MCP server card: https://agent.chiemgaufilms.com/.well-known/mcp/server-card.json
- Status and trust (uptime, delivery success, how failures are handled): https://agent.chiemgaufilms.com/status (German: /de/status), JSON: https://agent.chiemgaufilms.com/status.json
- German homepage for humans: https://agent.chiemgaufilms.com/de/
- Free input check, never charges: POST https://agent.chiemgaufilms.com/api/v1/preflight/{service-id}
- Paid calls: send the request without payment to get HTTP 402 with a PAYMENT-REQUIRED header, then retry with a PAYMENT-SIGNATURE header (x402 client, e.g. @x402/fetch). Network: eip155:8453, asset: USDC.
- Results can be fetched again with GET https://agent.chiemgaufilms.com/api/v1/results/{request_id} and "Authorization: Bearer {result_token}".

## Services (USDC per call)
- Keyword Metrics (0.12 USDC): POST https://agent.chiemgaufilms.com/api/v1/keyword-metrics — MCP tool keyword_metrics — Google Ads search volume, competition, CPC and 12-month history for up to 1000 keywords per call (DataForSEO Google Ads Search Volume Live).
- Keyword Ideas (0.025 USDC): POST https://agent.chiemgaufilms.com/api/v1/keyword-ideas — MCP tool keyword_ideas — Up to 25 keyword suggestions containing the words of one seed phrase, with search volume, CPC and competition (DataForSEO Labs Keyword Suggestions). Use it to find new phrases around one seed; use keyword_metrics for exact volumes of keywords you already have and keyword_difficulty for ranking difficulty.
- Google SERP (0.025 USDC): POST https://agent.chiemgaufilms.com/api/v1/google-serp — MCP tool google_serp — Top 10 organic Google results (position, URL, title, description) for a keyword, desktop (DataForSEO SERP Google Organic Live).
- Competitor Discovery (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/competitors — MCP tool competitors — Up to 10 organic search competitors of a domain with ranking overlap and traffic metrics (DataForSEO Labs Competitors Domain). Use it to find who competes with a domain; use keyword_gap to see which keywords a known competitor ranks for that you do not.
- Search Intent (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/search-intent — MCP tool search_intent — Search intent (informational, navigational, commercial, transactional) with probability for up to 10 keywords (DataForSEO Labs Search Intent). Use it to decide whether a keyword suits an informational, commercial or transactional page.
- AI Keyword Demand (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/ai-keyword-demand — MCP tool ai_keyword_demand — Modeled (estimated) AI-search demand for up to 10 keywords with 12-month history (DataForSEO AI Optimization Keyword Search Volume).
- Ranked Keywords (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/ranked-keywords — MCP tool ranked_keywords — Up to 25 Google keywords a domain ranks for, with position, ranking page, search volume, CPC and difficulty (DataForSEO Labs Ranked Keywords).
- Keyword Difficulty (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/keyword-difficulty — MCP tool keyword_difficulty — Keyword difficulty score (0-100) for up to 100 keywords (DataForSEO Labs Bulk Keyword Difficulty).
- Domain Overview (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/domain-overview — MCP tool domain_overview — Organic and paid search footprint of a domain: keyword count, estimated traffic, traffic value and ranking distribution (DataForSEO Labs Domain Rank Overview).
- Keyword Gap (0.045 USDC): POST https://agent.chiemgaufilms.com/api/v1/keyword-gap — MCP tool keyword_gap — Keywords a competitor ranks for in Google but your domain does not: up to 25, highest search volume first, with the competitor's ranking page (DataForSEO Labs Domain Intersection).
- Google Trends (0.025 USDC): POST https://agent.chiemgaufilms.com/api/v1/google-trends — MCP tool google_trends — Google Trends interest over time (past 12 months, relative 0-100) for up to 5 keywords compared against each other (DataForSEO Google Trends Explore Live).
- Local Business Search (0.03 USDC): POST https://agent.chiemgaufilms.com/api/v1/local-business — MCP tool local_business — Up to 20 Google Maps businesses for a query such as "plumber" or "coffee shop": name, category, address, phone, website, rating and coordinates (DataForSEO SERP Google Maps Live).
- Bing SERP (0.02 USDC): POST https://agent.chiemgaufilms.com/api/v1/bing-serp — MCP tool bing_serp — Top 10 organic Bing results (position, URL, title, description) for a keyword, desktop (DataForSEO SERP Bing Organic Live).
- Page Audit (0.02 USDC): POST https://agent.chiemgaufilms.com/api/v1/page-audit — MCP tool page_audit — Quick technical SEO audit of one public page: status code, title, meta description, headings, links, images, load time and on-page checks (DataForSEO On-Page Instant Pages, no JavaScript rendering).
- Domain Technologies (0.03 USDC): POST https://agent.chiemgaufilms.com/api/v1/domain-technologies — MCP tool domain_technologies — Technologies a website uses (CMS, analytics, servers, frameworks, marketing tools) grouped by category (DataForSEO Domain Analytics Technologies). Use it to see which CMS, analytics or marketing tools a competitor or prospect runs.
- Keywords for Site (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/keywords-for-site — MCP tool keywords_for_site — Up to 25 Google keywords relevant to a website, with search volume, CPC, competition, difficulty and intent (DataForSEO Labs Keywords For Site). Use it to find what a site should target; use ranked_keywords for what it already ranks for.
- Traffic Estimate (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/traffic-estimate — MCP tool traffic_estimate — Estimated monthly organic and paid Google traffic for up to 10 domains in one call (DataForSEO Labs Bulk Traffic Estimation).
- Google News Search (0.02 USDC): POST https://agent.chiemgaufilms.com/api/v1/news-search — MCP tool news_search — Top 10 Google News results for a keyword: headline, source, URL, snippet and publish time (DataForSEO SERP Google News Live). Use it for current coverage of a topic; use google_serp for regular web results.
- Google Image Search (0.02 USDC): POST https://agent.chiemgaufilms.com/api/v1/image-search — MCP tool image_search — Up to 20 Google Images results for a keyword: image URL, page URL, title and alt text (DataForSEO SERP Google Images Live).
- Local Market Check (package) (0.09 USDC): POST https://agent.chiemgaufilms.com/api/v1/local-market-check — MCP tool local_market_check — Package for one local search: top 10 organic Google results with the map box (local pack) and search features, plus top 10 Google Maps businesses, the competitor domains seen in them, optional position check for your domain and short observations (DataForSEO SERP Google Organic + Maps Live, one payment).
- Website Content (0.02 USDC): POST https://agent.chiemgaufilms.com/api/v1/website-content — MCP tool website_content — Extract bounded main-topic text, headings and public links from one page as JSON. Returns a reusable snapshot, source URL and provider fetch time. No JavaScript rendering.
- Website Changes (0.025 USDC): POST https://agent.chiemgaufilms.com/api/v1/website-changes — MCP tool website_changes — Fetch one page once and compare its bounded main-topic text with a caller-supplied previous snapshot for the same URL. Reports added/removed lines. No scheduler, screenshots or whole-site crawl; no semantic price interpretation.
- Regional Places (Chiemgau) (0.01 USDC): POST https://agent.chiemgaufilms.com/api/v1/regional-data — MCP tool regional_data — Search a small, curated Chiemgau places dataset: towns, natural sights and attractions with coordinates, German labels, Wikidata source revision, CC0 license and snapshot date. Local snapshot, not live opening hours or a complete directory.
- Website Check (package) (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/website-check — MCP tool website_check — Package: direct HTTPS/TLS and status check for one page, GET /sitemap.xml and HEAD of exactly two supplied same-origin links (four probes per payment). Identifies redirects and 404/410 links. No redirect following or full-site crawl. Sandbox mode returns explicitly simulated checks without network access.
- Open Data Catalog Search (0.01 USDC): POST https://agent.chiemgaufilms.com/api/v1/open-data-search — MCP tool open_data_search — Find public dataset catalog entries in GovData (Germany) or open.bydata (Bavaria): titles, short descriptions, publisher, source/identity links, source modification date, per-resource license references and access/download links. One catalog GET, up to 10 datasets; never downloads the actual source files. No API key needed.

## Content planning for agencies and video teams (USDC per call)
- Content Month Plan (0.05 USDC): POST https://agent.chiemgaufilms.com/api/v1/content-month-plan — MCP tool content_month_plan — Plan a content month for an agency: up to 30 posts with topics, publish dates and linked production dates, bundled shoot days, holidays per region, conflicts and an .ics file. EN/DE.
- Content Plan Re-Schedule (0.02 USDC): POST https://agent.chiemgaufilms.com/api/v1/content-plan-shift — MCP tool content_plan_shift — Move one date in a content calendar and let the linked dates follow: concept, shoot, edit, review and publish stay in order, a shared shoot day moves all its posts together, finished steps never move. Returns the change list, conflicts, blocked steps, a confirmation flag and the updated posts. Stateless: you send up to 40 posts, nothing is stored.
- Shoot Day Planner (0.03 USDC): POST https://agent.chiemgaufilms.com/api/v1/shoot-day-plan — MCP tool shoot_day_plan — Turn up to 12 planned videos into realistic shoot days: bundled by place, split evenly (max 3 shoots, 8 h), with set-up, breaks, lunch, timed schedule, equipment list, checklist and optional .ics files.
- Video Project Plan (0.08 USDC): POST https://agent.chiemgaufilms.com/api/v1/video-project-plan — MCP tool video_project_plan — One video job in one call: reel ideas for goal, trade and town, one shoot day in your time window, call sheet, sun times, post-production to delivery. DE/EN.
- Video Recipes (Shot Lists) (0.01 USDC): POST https://agent.chiemgaufilms.com/api/v1/video-recipes — MCP tool video_recipes — Get ready-made video recipes with hook, shot list, interview questions, equipment, recording time, platforms and follow-up formats (one shoot, several posts). Filter by category, words or exact recipe id. Content in German or English (language: de or en); the response also lists all recipe ids.
- Shoot Location Check (package) (0.04 USDC): POST https://agent.chiemgaufilms.com/api/v1/shoot-location-check — MCP tool shoot_location_check — One payment, one location and date in Germany: golden hour, sunrise and sunset, official DWD forecast for the day from the nearest station (temperature, rain, wind, clouds, hourly) and Bavarian nature, landscape, bird and habitat protection areas near the point. Up to 2 free public source requests; no drone-zone or permit data.

## Notes
- Content planning services answer in German (default) or English: send "language": "en". Recipe, category and goal ids stay the same in both languages.
- For businesses only (B2B). Calling a paid endpoint means you act as a business and accept the terms of use: https://agent.chiemgaufilms.com/legal.html#terms
- location_code is a country-level DataForSEO code (2840 United States, 2276 Germany, 2826 United Kingdom); the Google SERP family (google-serp, local-business, news-search, image-search, local-market-check) also takes DACH city/region codes from /api/v1/locations. Unsupported location/language pairs are rejected with HTTP 422 before any payment is requested.
- AI keyword demand values are modeled estimates, not measured prompt counts.
- Every response states data_source: "live" or "sandbox".
- MCP paid tools need an x402-capable MCP client (for example built with @x402/mcp); free tools work with any MCP client.

- Set an explicit buyer spending limit before signing. If payment or delivery is uncertain, preserve the attempt and check the original payment; never automatically create a replacement payment.