analyze_url
Run a deep competitive analysis of a URL — SERP, topic coverage, content structure, and gap analysis.
Analyze a URL and generate a deep brief. Pendium scrapes the page, runs SERP analysis for the target keyword, analyzes competing pages, and produces a structured brief with topic coverage, content-structure patterns, competitive gaps, and writer guidance. Use it on cited sources from get_cited_sources, competitor pages, or any URL you want to outperform.
This is an async operation — it returns a briefId you poll with get_analyzed_url (typically 30–60 seconds).
Authentication: Required — Starter or Pro plan (uses LLM credits for scraping and analysis).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
syntheticId | integer | Yes | The agent ID to create the brief for. Grounds the analysis in this brand's context. |
sourceUrl | string (URL) | Yes | The URL to analyze — a cited source, competitor page, or any URL. |
Returns
briefId, status, and reused. Calling the tool twice on the same agent + URL returns the existing brief instead of re-billing. Poll get_analyzed_url with the briefId until status is completed.