superagnt/leverage / skills/core/social-data
social-data
VerifiedUnified data API for AI agents. One API key for LinkedIn, YouTube, TikTok, X, Instagram, Reddit, and Facebook, plus web scraping, SEO data, and hosted webhook receiving. Structured JSON, no infra to run.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 21.0 KB |
| references/facebook/README.md | markdown | 29.2 KB |
| references/instagram/README.md | markdown | 16.2 KB |
| references/linkedin/README.md | markdown | 33.5 KB |
| references/reddit/README.md | markdown | 17.6 KB |
| references/seo/README.md | markdown | 26.2 KB |
| references/tiktok/README.md | markdown | 6.3 KB |
| references/web/README.md | markdown | 6.7 KB |
| references/x/README.md | markdown | 32.0 KB |
| references/youtube/README.md | markdown | 13.8 KB |
references/seo/README.md
View on GitHub# SEO API Reference
**App name:** `seo`
**Base URL:** `https://api.superagnt.com/v1/data/seo`
**Endpoints:** 22
Live Google results, keyword research, competitor and backlink gaps, page audits and AI answer visibility, all as agent tools.
## Authentication
All requests require the superagnt API key:
```
Authorization: Bearer $SUPERAGNT_API_KEY
```
---
## Available Endpoints
| Method | Path | Summary |
|--------|------|---------|
| `POST` | `/serp` | Live Google search results |
| `POST` | `/serp-ai-mode` | Google AI Mode results |
| `POST` | `/keyword-ideas` | Keyword ideas from seed keywords |
| `POST` | `/keyword-overview` | Metrics for specific keywords |
| `POST` | `/search-intent` | Classify keyword search intent |
| `POST` | `/ranked-keywords` | Keywords a domain ranks for |
| `POST` | `/keyword-gap` | Keyword gap between two domains |
| `POST` | `/competitors` | Find a domain's organic competitors |
| `POST` | `/domain-overview` | Domain rank and traffic overview |
| `POST` | `/backlinks-summary` | Backlink profile summary |
| `POST` | `/referring-domains` | Referring domains for a target |
| `POST` | `/backlink-gap` | Domains linking to competitors but not you |
| `POST` | `/page-audit` | Instant on-page audit of a URL |
| `POST` | `/ai-visibility` | How often LLMs mention a domain |
| `POST` | `/chatgpt-app-answer` | ChatGPT app answer |
| `POST` | `/gemini-app-answer` | Gemini app answer |
| `POST` | `/chatgpt-api-answer` | OpenAI API answer with citations |
| `POST` | `/claude-api-answer` | Claude API answer with citations |
| `POST` | `/gemini-api-answer` | Gemini API answer with citations |
| `POST` | `/perplexity-api-answer` | Perplexity API answer with citations |
| `POST` | `/tech-stack` | Technologies a website runs |
| `POST` | `/tech-search` | Find websites by technology |
## Tool Schemas
The following JSON defines all available tools with their parameters. Each tool maps to an API endpoint.
```json
[
{
"name": "superagnt_seo_google_search",
"description": "Live Google search results",
"method": "POST",
"path": "/serp",
"parameters": {
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "The search query. Supports Google search operators (site:, inurl:, filetype:), which cost roughly 5x."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Common values: 2840 United States (default), 2826 United Kingdom, 2124 Canada, 2036 Australia, 2276 Germany, 2250 France, 2724 Spain, 2356 India, 2076 Brazil."
},
"language_code": {
"type": "string",
"description": "Two-letter language code, e.g. 'en' (default), 'de', 'es', 'fr', 'pt'."
},
"device": {
"type": "string",
"description": "Device type to emulate. Default 'desktop'."
},
"depth": {
"type": "integer",
"description": "Number of results to return, in steps of 10. Default 10 (cheapest). Each additional 10 results bills as one more results page."
},
"load_async_ai_overview": {
"type": "boolean",
"description": "Set to true to load AI Overviews that Google renders asynchronously, so the `ai_overview` item comes back with its text and cited sources (`markdown`, `items`, `references`). Left off, an async overview still appears, flagged `asynchronous_ai_overview: true`, but with those fields null: you can tell an overview exists, not what it cites. In the default markdown view, the overview row lists its cited sources as `cited_domains`. Adds up to about 0.36 cents per call (roughly double the default-depth price), charged only when an overview actually had to be loaded; the response's `meta.costCents` shows what the call billed. When Google is too slow to load it, or the data provider fails to, the answer comes from a plain search instead, billed as one and marked in `meta.agnt_fallback` with the reason. Default false."
}
},
"required": [
"keyword"
]
}
},
{
"name": "superagnt_seo_google_ai_mode_search",
"description": "Google AI Mode results",
"method": "POST",
"path": "/serp-ai-mode",
"parameters": {
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "The question or query to run through Google AI Mode."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Common values: 2840 United States (default), 2826 United Kingdom, 2124 Canada, 2036 Australia, 2276 Germany."
},
"language_code": {
"type": "string",
"description": "Two-letter language code, e.g. 'en' (default)."
}
},
"required": [
"keyword"
]
}
},
{
"name": "superagnt_seo_keyword_ideas",
"description": "Keyword ideas from seed keywords",
"method": "POST",
"path": "/keyword-ideas",
"parameters": {
"type": "object",
"properties": {
"keywords": {
"type": "array",
"description": "Seed keywords to expand (1-200)."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Default 2840 (United States)."
},
"language_code": {
"type": "string",
"description": "Language code, e.g. 'en', 'de' or 'zh-TW'. A location takes only its own languages ('en' or 'es' for the United States, 'de' for Germany, 2276), and any other is refused. Default: 'en' where the location offers it, otherwise the location's main language."
},
"limit": {
"type": "integer",
"description": "Max keyword ideas to return. Default 100. Cost scales with rows, so raise only when needed."
},
"offset": {
"type": "integer",
"description": "Pagination offset."
},
"filters": {
"type": "array",
"description": "Optional filter expression as [field, operator, value] triples joined by 'and'/'or'. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like (use %% wildcards with like). Recipes: [[\"keyword_info.search_volume\",\">\",100]] · keep only on-topic ideas: [[\"keyword\",\"like\",\"%deliverability%\"]] · combine: [[\"keyword_info.search_volume\",\">\",100],\"and\",[\"keyword_properties.keyword_difficulty\",\"<\",40]]."
},
"order_by": {
"type": "array",
"description": "Sort rules, e.g. [\"keyword_info.search_volume,desc\"]."
}
},
"required": [
"keywords"
]
}
},
{
"name": "superagnt_seo_keyword_overview",
"description": "Metrics for specific keywords",
"method": "POST",
"path": "/keyword-overview",
"parameters": {
"type": "object",
"properties": {
"keywords": {
"type": "array",
"description": "The exact keywords to look up (1-700). Cost scales with the number of keywords."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Default 2840 (United States)."
},
"language_code": {
"type": "string",
"description": "Language code, e.g. 'en', 'de' or 'zh-TW'. A location takes only its own languages ('en' or 'es' for the United States, 'de' for Germany, 2276), and any other is refused. Default: 'en' where the location offers it, otherwise the location's main language."
}
},
"required": [
"keywords"
]
}
},
{
"name": "superagnt_seo_search_intent",
"description": "Classify keyword search intent",
"method": "POST",
"path": "/search-intent",
"parameters": {
"type": "object",
"properties": {
"keywords": {
"type": "array",
"description": "Keywords to classify (1-1000). Cost scales with the number of keywords."
},
"language_code": {
"type": "string",
"description": "Two-letter language code. Default 'en'."
}
},
"required": [
"keywords"
]
}
},
{
"name": "superagnt_seo_ranked_keywords",
"description": "Keywords a domain ranks for",
"method": "POST",
"path": "/ranked-keywords",
"parameters": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "Domain (e.g. 'example.com', no protocol) or full page URL to analyze."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Default 2840 (United States)."
},
"language_code": {
"type": "string",
"description": "Language code, e.g. 'en', 'de' or 'zh-TW'. A location takes only its own languages ('en' or 'es' for the United States, 'de' for Germany, 2276), and any other is refused. Default: 'en' where the location offers it, otherwise the location's main language."
},
"limit": {
"type": "integer",
"description": "Max keywords to return. Default 100. Cost scales with rows."
},
"offset": {
"type": "integer",
"description": "Pagination offset."
},
"filters": {
"type": "array",
"description": "Optional filter expression, e.g. [[\"ranked_serp_element.serp_item.rank_absolute\", \"<=\", 20]]."
},
"order_by": {
"type": "array",
"description": "Sort rules, e.g. [\"keyword_data.keyword_info.search_volume,desc\"]."
}
},
"required": [
"target"
]
}
},
{
"name": "superagnt_seo_keyword_gap",
"description": "Keyword gap between two domains",
"method": "POST",
"path": "/keyword-gap",
"parameters": {
"type": "object",
"properties": {
"target1": {
"type": "string",
"description": "First domain (e.g. your domain), no protocol."
},
"target2": {
"type": "string",
"description": "Second domain (e.g. a competitor), no protocol."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Default 2840 (United States)."
},
"language_code": {
"type": "string",
"description": "Language code, e.g. 'en', 'de' or 'zh-TW'. A location takes only its own languages ('en' or 'es' for the United States, 'de' for Germany, 2276), and any other is refused. Default: 'en' where the location offers it, otherwise the location's main language."
},
"limit": {
"type": "integer",
"description": "Max intersecting keywords to return. Default 100."
},
"offset": {
"type": "integer",
"description": "Pagination offset."
},
"filters": {
"type": "array",
"description": "Optional filter expression as [field, operator, value] triples joined by 'and'/'or'. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like. Recipe (their wins, your gaps): [[\"first_domain_serp_element.rank_absolute\",\">\",20],\"and\",[\"second_domain_serp_element.rank_absolute\",\"<=\",10]]."
},
"order_by": {
"type": "array",
"description": "Sort rules."
}
},
"required": [
"target1",
"target2"
]
}
},
{
"name": "superagnt_seo_competitors",
"description": "Find a domain's organic competitors",
"method": "POST",
"path": "/competitors",
"parameters": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "Domain to find competitors for, no protocol."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Default 2840 (United States)."
},
"language_code": {
"type": "string",
"description": "Language code, e.g. 'en', 'de' or 'zh-TW'. A location takes only its own languages ('en' or 'es' for the United States, 'de' for Germany, 2276), and any other is refused. Default: 'en' where the location offers it, otherwise the location's main language."
},
"limit": {
"type": "integer",
"description": "Max competitor domains to return. Default 100."
},
"filters": {
"type": "array",
"description": "Optional filter expression as [field, operator, value] triples. Recipe: [[\"intersections\",\">\",50]] keeps only domains sharing 50+ keywords with the target."
},
"order_by": {
"type": "array",
"description": "Sort rules, e.g. [\"intersections,desc\"]."
}
},
"required": [
"target"
]
}
},
{
"name": "superagnt_seo_domain_overview",
"description": "Domain rank and traffic overview",
"method": "POST",
"path": "/domain-overview",
"parameters": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "Domain to summarize, no protocol."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Default 2840 (United States)."
},
"language_code": {
"type": "string",
"description": "Language code, e.g. 'en', 'de' or 'zh-TW'. A location takes only its own languages ('en' or 'es' for the United States, 'de' for Germany, 2276), and any other is refused. Default: 'en' where the location offers it, otherwise the location's main language."
}
},
"required": [
"target"
]
}
},
{
"name": "superagnt_seo_backlinks_summary",
"description": "Backlink profile summary",
"method": "POST",
"path": "/backlinks-summary",
"parameters": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "Domain, subdomain or full page URL. Domains without protocol; pages with protocol."
},
"include_subdomains": {
"type": "boolean",
"description": "Count links to subdomains too. Default true."
},
"exclude_internal_backlinks": {
"type": "boolean",
"description": "Ignore links from the target to itself. Default true."
}
},
"required": [
"target"
]
}
},
{
"name": "superagnt_seo_referring_domains",
"description": "Referring domains for a target",
"method": "POST",
"path": "/referring-domains",
"parameters": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "Domain, subdomain or full page URL to list referring domains for."
},
"limit": {
"type": "integer",
"description": "Max referring domains to return. Default 100. Cost scales with rows."
},
"offset": {
"type": "integer",
"description": "Pagination offset."
},
"exclude_internal_backlinks": {
"type": "boolean",
"description": "Ignore links from the target to itself. Default true."
},
"filters": {
"type": "array",
"description": "Optional filter expression as [field, operator, value] triples. Operators: =, <>, <, <=, >, >=, in, not_in, like, not_like. Recipe: [[\"rank\",\">\",100]] keeps stronger referring domains (rank is the referring domain's authority, higher is better)."
},
"order_by": {
"type": "array",
"description": "Sort rules, e.g. [\"rank,desc\"]."
}
},
"required": [
"target"
]
}
},
{
"name": "superagnt_seo_backlink_gap",
"description": "Domains linking to competitors but not you",
"method": "POST",
"path": "/backlink-gap",
"parameters": {
"type": "object",
"properties": {
"targets": {
"type": "array",
"description": "Competitor domains whose backlink sources to intersect (1-20)."
},
"exclude_targets": {
"type": "array",
"description": "Domains the referring sites must NOT already link to. Put your own domain here."
},
"limit": {
"type": "integer",
"description": "Max referring domains to return. Default 100."
},
"offset": {
"type": "integer",
"description": "Pagination offset."
},
"filters": {
"type": "array",
"description": "Optional filter expression, e.g. minimum domain rank."
},
"order_by": {
"type": "array",
"description": "Sort rules, e.g. [\"1.rank,desc\"]."
}
},
"required": [
"targets"
]
}
},
{
"name": "superagnt_seo_page_audit",
"description": "Instant on-page audit of a URL",
"method": "POST",
"path": "/page-audit",
"parameters": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "The page URL to audit (with protocol)."
},
"enable_javascript": {
"type": "boolean",
"description": "Render JavaScript before auditing. Slower; only for JS-rendered pages."
}
},
"required": [
"url"
]
}
},
{
"name": "superagnt_seo_ai_visibility",
"description": "How often LLMs mention a domain",
"method": "POST",
"path": "/ai-visibility",
"parameters": {
"type": "object",
"properties": {
"targets": {
"type": "array",
"description": "Domains to measure LLM mention metrics for, no protocol. Pass at least one of targets or keywords."
},
"keywords": {
"type": "array",
"description": "Keyword phrases to measure LLM mention metrics for, as an alternative or addition to domains."
},
"limit": {
"type": "integer",
"description": "Max rows to return. Default 100. Cost scales with rows."
}
}
}
},
{
"name": "superagnt_seo_chatgpt_app_answer",
"description": "ChatGPT app answer",
"method": "POST",
"path": "/chatgpt-app-answer",
"parameters": {
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "The question to ask ChatGPT, as a user would type it."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Common values: 2840 United States (default), 2826 United Kingdom, 2124 Canada, 2036 Australia, 2276 Germany."
},
"language_code": {
"type": "string",
"description": "Two-letter language code, e.g. 'en' (default)."
},
"force_web_search": {
"type": "boolean",
"description": "Push ChatGPT to search the web and cite current sources. Citations are still not guaranteed."
}
},
"required": [
"keyword"
]
}
},
{
"name": "superagnt_seo_gemini_app_answer",
"description": "Gemini app answer",
"method": "POST",
"path": "/gemini-app-answer",
"parameters": {
"type": "object",
"properties": {
"keyword": {
"type": "string",
"description": "The question to ask Gemini, as a user would type it."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Common values: 2840 United States (default), 2826 United Kingdom, 2124 Canada, 2036 Australia, 2276 Germany."
},
"language_code": {
"type": "string",
"description": "Two-letter language code, e.g. 'en' (default)."
}
},
"required": [
"keyword"
]
}
},
{
"name": "superagnt_seo_chatgpt_api_answer",
"description": "OpenAI API answer with citations",
"method": "POST",
"path": "/chatgpt-api-answer",
"parameters": {
"type": "object",
"properties": {
"user_prompt": {
"type": "string",
"description": "The question to ask the model."
},
"model_name": {
"type": "string",
"description": "The model to ask: gpt-4o-mini, gpt-4o, gpt-5-mini (default gpt-4o-mini)."
},
"max_output_tokens": {
"type": "integer",
"description": "Cap on the answer's length in tokens, 16-2048 (default 1024). Web search can push a model slightly past it. gpt-5-mini needs at least 1024."
},
"web_search": {
"type": "boolean",
"description": "Let the model search the web and cite sources (default true). Citations are still not guaranteed."
},
"force_web_search": {
"type": "boolean",
"description": "Push the model to search the web before answering. Needs `web_search`; citations are still not guaranteed."
},
"web_search_country_iso_code": {
"type": "string",
"description": "Two-letter country code the web search runs from, e.g. 'US'."
}
},
"required": [
"user_prompt"
]
}
},
{
"name": "superagnt_seo_claude_api_answer",
"description": "Claude API answer with citations",
"method": "POST",
"path": "/claude-api-answer",
"parameters": {
"type": "object",
"properties": {
"user_prompt": {
"type": "string",
"description": "The question to ask the model."
},
"model_name": {
"type": "string",
"description": "The model to ask: claude-haiku-4-5, claude-sonnet-4-5, claude-haiku-5-5, claude-sonnet-5-5, claude-opus-5-5 (default claude-haiku-4-5)."
},
"max_output_tokens": {
"type": "integer",
"description": "Cap on the answer's length in tokens, 16-2048 (default 1024). Web search can push a model slightly past it."
},
"web_search": {
"type": "boolean",
"description": "Let the model search the web and cite sources (default true). Citations are still not guaranteed."
},
"force_web_search": {
"type": "boolean",
"description": "Push the model to search the web before answering. Needs `web_search`; citations are still not guaranteed."
},
"web_search_country_iso_code": {
"type": "string",
"description": "Two-letter country code the web search runs from, e.g. 'US'."
}
},
"required": [
"user_prompt"
]
}
},
{
"name": "superagnt_seo_gemini_api_answer",
"description": "Gemini API answer with citations",
"method": "POST",
"path": "/gemini-api-answer",
"parameters": {
"type": "object",
"properties": {
"user_prompt": {
"type": "string",
"description": "The question to ask the model."
},
"model_name": {
"type": "string",
"description": "The model to ask: gemini-2.5-flash-lite, gemini-2.5-flash, gemini-2.0-flash (default gemini-2.5-flash-lite)."
},
"max_output_tokens": {
"type": "integer",
"description": "Cap on the answer's length in tokens, 16-2048 (default 1024). Web search can push a model slightly past it."
},
"web_search": {
"type": "boolean",
"description": "Let the model search the web and cite sources (default true). Citations are still not guaranteed."
}
},
"required": [
"user_prompt"
]
}
},
{
"name": "superagnt_seo_perplexity_api_answer",
"description": "Perplexity API answer with citations",
"method": "POST",
"path": "/perplexity-api-answer",
"parameters": {
"type": "object",
"properties": {
"user_prompt": {
"type": "string",
"description": "The question to ask the model."
},
"model_name": {
"type": "string",
"description": "The model to ask: sonar, sonar-pro (default sonar)."
},
"max_output_tokens": {
"type": "integer",
"description": "Cap on the answer's length in tokens, 16-2048 (default 1024). Web search can push a model slightly past it."
},
"web_search_country_iso_code": {
"type": "string",
"description": "Two-letter country code the web search runs from, e.g. 'US'. Sonar models always search the web."
}
},
"required": [
"user_prompt"
]
}
},
{
"name": "superagnt_seo_tech_stack",
"description": "Technologies a website runs",
"method": "POST",
"path": "/tech-stack",
"parameters": {
"type": "object",
"properties": {
"target": {
"type": "string",
"description": "Domain to inspect, no protocol."
}
},
"required": [
"target"
]
}
},
{
"name": "superagnt_seo_tech_search",
"description": "Find websites by technology",
"method": "POST",
"path": "/tech-search",
"parameters": {
"type": "object",
"properties": {
"technologies": {
"type": "array",
"description": "Technology names the sites must run, e.g. [\"Shopify\", \"Klaviyo\"]. Multiple entries intersect."
},
"limit": {
"type": "integer",
"description": "Max domains to return. Default 100. Per-row cost is high; raise deliberately."
},
"offset": {
"type": "integer",
"description": "Pagination offset."
},
"filters": {
"type": "array",
"description": "Optional filter expression, e.g. [[\"country_iso_code\", \"=\", \"US\"]]."
},
"order_by": {
"type": "array",
"description": "Sort rules, e.g. [\"domain_rank,desc\"]."
}
},
"required": [
"technologies"
]
}
}
]
```
## Example
```bash
curl -X POST "https://api.superagnt.com/v1/data/seo/serp" \
-H "Authorization: Bearer $SUPERAGNT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"key": "value"}'
```
## Links
- [Documentation](https://superagnt.com/docs)
- [API Reference](https://superagnt.com/docs/apis/seo)
- [superagnt app](https://app.superagnt.com/dashboard)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |