Keywords for Site
Keywords for Site records connect a website topic with relevant search terms, search volume, CPC, paid competition, monthly demand, and category context. These keyword and metric relationships support topic discovery, competitor research, candidate-list building, and cross-domain comparison.
Features
- Domain-based relevance discoveryUse one website domain to retrieve keyword ideas associated with its topic instead of starting from a seed phrase.
- Demand and paid-search metricsEvaluate each returned keyword through normalized search volume, CPC, paid competition, competition level, and monthly search observations.
- Complete keyword contextInspect extra for the complete returned row, where optional categories, difficulty, intent, trend fields, and other non-promoted attributes remain accessible.
Parameters
| Parameters | Required | Description |
|---|---|---|
target | Required | Required website domain used as the topic source. The Playground defaults to microsoft.com. |
location_code | Optional | Optional positive search-market location code. The Playground submits 2840 by default. |
location_name | Optional | Optional search-market name alternative to location_code. When filled, it takes precedence over location_code. |
language_code | Optional | Optional search language code from 2 through 10 characters. The Playground submits en by default. |
language | Optional | Optional search-language name alternative to language_code. When filled, it takes precedence over language_code. |
results_limit | Optional | Requested source-result ceiling from 1 through 1,000. The Playground submits 5 to match the documentation example; the backend uses 100 when omitted. |
How to Use
Submit one domain with market, language, and result-limit settings, then read the normalized keyword records from the completed task.
- Choose one domain target, a positive location_code, a language_code, and a results_limit from 1 through 1,000.
- POST the payload to /v1/seo/keywords-for-site and save the returned task_id.
- Poll /v1/tasks/{task_id} until the task succeeds or returns a failure.
- Read data.results.items, then follow next_cursor while has_more remains true.
curl -X POST "https://api.socq.ai/v1/seo/keywords-for-site" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"target":"microsoft.com","location_code":2840,"language_code":"en","results_limit":5}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Website topic discovery: Use returned keywords and categories to identify search themes associated with a known website.
- Competitor keyword research: Submit a competitor domain and combine relevant terms with search volume, CPC, and paid competition to assemble a research set.
- Cross-domain topic comparison: Run website targets separately and compare their returned keyword sets, categories, and demand metrics.
Pro Tips
- Remove http:// and https:// from target before submitting the domain to avoid an invalid target format.
- Set the market and language explicitly when comparing runs instead of relying on provider behavior for omitted fields.
- Choose results_limit as the largest useful single result set because this endpoint has no offset for requesting a later result window.
- Treat missing metrics as unavailable rather than zero, and inspect extra when a required attribute is not present in the normalized fields.
- Use Ranked Keywords instead when the task requires observed positions or ranking URLs rather than relevance-based keyword ideas.
Related APIs
Use these APIs when you need a different type of public SEO data.
- Google Organic SERP API — Retrieve one live Google result page by query and market with normalized destinations, ranks, element types, and full result details.
- Keyword Difficulty API — Compare organic ranking difficulty for a submitted keyword batch, returning each available keyword with its normalized score.
- Keyword Overview API — Enrich a submitted keyword batch with available demand, paid competition, difficulty, monthly-search, and intent context.
- Keyword Search Volume API — Measure known keywords with available search volume, CPC, paid competition, and monthly search history.
- Keyword Suggestions API — Expand one seed query into matching long-tail terms with available demand measurements, monthly history, intent context, and complete source rows.
- Ranked Keywords API — Find keywords a domain, subdomain, or page ranks for, with matching URLs, positions, search measurements, intent, and complete source elements.
- Related Keywords API — Follow related-search paths from one seed query with depth controls, available keyword measurements, intent context, and complete source rows.
- Relevant Pages API — Inventory indexed pages for one domain with organic and paid ranking distributions, modeled traffic, and estimated cost context.
- Search Intent API — Classify primary and secondary search intent for a submitted keyword batch while preserving source probabilities and complete records.
Combine SEO data with public data from other supported social platforms.