Content Briefing API
Request
Analyzes the top pages for a keyword and returns targets for your text: length, structure, important keywords and phrases.
https://seorch.net/api/content-briefing/?key=YOUR_KEY&keyword=seo%20tool&country=de
Parameters
| Parameters | Required | Meaning |
|---|---|---|
key | yes | Your API key, alternatively in the X-API-Key header |
keyword | yes | The keyword |
country | no | de, at, ch, uk, us or es |
sites | no | Up to 10 custom comparison pages instead of the Google results |
stopwords | no | Words to exclude from the analysis |
url | no | Your page, its values are returned in your_page |
Response
| Field | Meaning |
|---|---|
competitors | The compared pages with words, sentences, keyword count, readability and headings |
summary | Averages as targets |
keywords | must_have, should_have and more by frequency across the pages |
phrases, keyword_occurrences | Important phrases and the frequency and density of the keyword |
{
"api_version": 1,
"keyword": "seo tool",
"country": "de",
"your_page": {
"url": "https://www.getmad.de/",
"words": 2721,
"keyword_count": 0,
"flesch": 69,
"questions": 8,
"h1": 0,
"h2": 49
},
"competitors": [
{
"rank": 1,
"url": "https://www.eology.de/magazine/praktische-seo-tool-tipps",
"analysed": true,
"words": 2779,
"words_in_sentences": 1931,
"keyword_count": 0,
"flesch": 54,
"questions": 12,
"h1": 1,
"h2": 7,
"sentences": 105
}
],
"summary": {
"sites_analysed": 9,
"sites_compared": 9,
"words": 3568,
"sentences": 170,
"flesch": 51
},
"keyword_occurrences": [
{
"keyword": "seo tool",
"average_count": 6,
"density_percent": 0.17
}
],
"keywords": {
"must_have": [
"seo",
"tools",
"daten"
],
"should_have": [
"erstellen",
"optimieren",
"kleine"
],
"more": [
"sitemap",
"neilpatel",
"test"
]
},
"phrases": [
"mit seo tools",
"seo tools seo"
],
"wikipedia": {
"entities": [],
"internal_links": []
}
}Errors
Errors are returned as JSON with a fixed code. All APIs use missing_key and invalid_key (401), rate_limited (429) and missing or invalid parameters (400). Additionally for this API: url_not_allowed, no_sites_analysed, upstream_error.
Limits
Each key allows 10 requests per minute and 500 per day. Higher limits are available on request.
Contents