DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis: samenvatting
Geaggregeerd beeld van elke citatie van een keyword in de webindex. Retourneert total_count, rank, top_domains (elk domain en count), sentiment_connotations (anger, happiness, love, sadness, share, fun), connotation_types (positive, negative, neutral), text_categories, page_categories, page_types, countries en languages. Dit is het knooppunt van de content-familie: post_dataforseo_content_sentiment_analysis_live retourneert alleen de twee connotatieblokken die hier al in zitten, dus gebruik dit endpoint, tenzij je specifiek de kleinere payload wilt. Voor de afzonderlijke citerende pagina's in plaats van de totalen gebruik je post_dataforseo_content_search_live; voor hetzelfde aggregaat over tijd post_dataforseo_content_phrase_trends_live.
Prijsreferentie
- Afrekening: gerapporteerde responskosten.
- Referentieschatting per verzoek: USD 0.0276.
- Referentiemultiplier voor klanten: 1.0. Niet opnieuw toepassen op een al afgerekend klantbedrag.
Alleen referentiemetadata, geen accountofferte en geen gegarandeerde prijs of bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.
- Type: array (object | null)[]
- initialType: array (object | null)[] | null
_dataset _filters filterparameters voor de initiële dataset
optioneel veld
initiële filterparameters die van toepassing zijn op velden in het Search-endpoint
u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
tussen de voorwaarden zet u een logische operatorandofor
de volgende operators worden ondersteund:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,has,has_not
met de operator%inlikeennot_likekunt u elke tekenreeks van nul of meer tekens matchen
voorbeeld:["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
meer informatie over filters vindt u in Content Analysis API - Filters
meer over de filters van de initiële dataset leest u in dit Help Center-artikel.Leeg object - internalType: integer | null
_list _limit maximaal aantal elementen in interne arrays
optioneel veld
met dit veld beperkt u het aantal elementen in de volgende arrays:top_domainstext_categoriespage_categoriescountrieslanguages
standaardwaarde:1
maximale waarde:20 - keywordType: string
doelkeyword
verplicht veld
UTF-8-codering
de keywords worden omgezet naar kleine letters;
Let op: gebruik dubbele aanhalingstekens en backslashes om een exacte zin te matchen in plaats van een los keyword;
voorbeeld:"keyword": ""tesla palo alto""meer informatie over regels en beperkingen voor de velden
keywordenkeywordsin DataForSEO-API's vindt u in dit Help Center-artikel - keywordType: object | null
_fields doelvelden en doelkeywords
optioneel veld
met deze parameter filtert u de dataset op keywords die in bepaalde velden moeten voorkomen;
velden die u kunt opgeven:title,main_title,previous_title,snippet
u kunt meerdere velden opgeven;
Let op: gebruik dubbele aanhalingstekens en backslashes om een exacte zin te matchen in plaats van een los keyword;
voorbeeld:"keyword_fields": {
"snippet": ""logitech mouse"",
"main_title": "sale"
}- propertyType: string | null
Name
- pageType: array string[] | null
_type doeltypen pagina's
optioneel veld
met deze parameter filtert u de dataset op paginatypen
mogelijke waarden:"ecommerce","news","blogs","message-boards","organization" - positiveType: number | null
_connotation _threshold drempelwaarde voor positieve connotatie
optioneel veld
opgegeven als drempelwaarde voor de waarschijnlijkheidsindex van positief sentiment in de inhoud van de citatie
als u dit veld opgeeft, bevat het objectconnotation_typesin de respons alleen gegevens over citaties waarvan de waarschijnlijkheid vanpositivesentiment groter dan of gelijk aan de opgegeven waarde is
mogelijke waarden: van0tot1
standaardwaarde:0.4 - rankType: string | null
_scale bepaalt de schaal die wordt gebruikt voor het berekenen en weergeven van de waarden
rank
optioneel veldmet deze parameter kiest u of rangwaarden op een schaal van 0–100 of 0–1000 worden weergegeven
mogelijke waarden:
one_hundred— rangwaarden worden weergegeven op een schaal van 0–100one_thousand— rangwaarden worden weergegeven op een schaal van 0–1000standaardwaarde:
one_thousandlees meer over hoe deze parameter werkt in dit Help Center-artikel
- sentimentsType: number | null
_connotation _threshold drempelwaarde voor sentimentconnotatie
optioneel veld
opgegeven als drempelwaarde voor de waarschijnlijkheidsindex van sentimentconnotaties in de inhoud van de citatie
als u dit veld opgeeft, bevat het objectsentiment_connotationsin de respons alleen gegevens over citaties waarbij
de waarschijnlijkheid per sentiment groter dan of gelijk aan de opgegeven waarde is
mogelijke waarden: van0tot1
standaardwaarde:0.4 - tagType: string | null
door gebruiker gedefinieerde taak-ID
optioneel veld
de tekenslimiet is 255
je kunt deze parameter gebruiken om de taak te identificeren en aan het resultaat te koppelen
de opgegeven waardetagvind je in hetdata-object van de respons
- Type: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveResponseInfo200
- Type: number | null Formaat: doublecost
Totale kosten van taken, USD
- Type: integer | nullstatus
_code algemene statuscode de volledige lijst met responscodes vindt u hier
- Type: string | nullstatus
_message algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier
- Type: array (object | null)[] | nulltasks
array van taken
- Type: object | null · Response36Afe1097B20_ContentAnalysisSummaryLiveTaskInfo
- costType: number | null Formaat: double
Totale kosten van taken, USD
- dataType: object | null
Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven
- propertyType: object | null
Name
- idType: string | null
taak-id eenduidige taak-id in ons systeem in UUID-indeling
- pathType: array (string | null)[] | null
URL-pad
- resultType: array (object | null)[] | null
array van resultaten
- connotationType: object | null
_types connotatietypen
bevat typen sentimenten (sentimentpolariteit) met betrekking tot de vermelding van het keyword en het aantal vermeldingen per sentimenttype
mogelijke typen sentimentconnotatie:positive,negative,neutral- propertyType: integer | null Formaat: int64
Name Signed 64-bit integers (long type).
- countriesType: object | null
- propertyType: integer | null Formaat: int64
Name Signed 64-bit integers (long type).
- languagesType: object | null
- propertyType: integer | null Formaat: int64
Name Signed 64-bit integers (long type).
- pageType: array (object | null)[] | null
_categories - categoryType: array (integer | null)[] | null
- countType: integer | null Formaat: int64
Signed 64-bit integers (long type).
- pageType: object | null
_types paginatypen
bevat paginatypen en het aantal vermeldingen per paginatype- propertyType: integer | null Formaat: int64
Name Signed 64-bit integers (long type).
- rankType: integer | null
rang van alle URL's die het
keywordvermelden
genormaliseerde som van de rangen van alle URL's die het doel-keywordvermelden - sentimentType: object | null
_connotations sentimentconnotaties
bevat sentimenten (emotionele reacties) met betrekking tot de vermelding van het doelkeyword en het aantal vermeldingen per sentiment
mogelijke sentimentconnotaties:anger,happiness,love,sadness,share,fun- propertyType: integer | null Formaat: int64
Name Signed 64-bit integers (long type).
- textType: array (object | null)[] | null
_categories - categoryType: array (integer | null)[] | null
- countType: integer | null Formaat: int64
Signed 64-bit integers (long type).
- topType: array (object | null)[] | null
_domains topdomeinen die het doelkeyword vermelden
bevat objecten met topdomeinen die het doelkeyword vermelden en het aantal vermeldingen per domein- countType: integer | null Formaat: int64
Signed 64-bit integers (long type).
- domainType: string | null
- totalType: integer | null Formaat: int64
_count totaal aantal resultaten in onze database dat relevant is voor uw verzoek
- typeType: string | null
elementtype
- resultType: integer | null Formaat: int64
_count Aantal elementen in de result-array
- statusType: integer | null
_code statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier
- statusType: string | null
_message informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier
- timeType: string | null
Uitvoeringstijd in seconden
- Type: integer | null Formaat: int64tasks
_count Het aantal taken in de tasks-array
- Type: integer | null Formaat: int64tasks
_error Het aantal taken in de tasks-array dat met een fout is geretourneerd
- Type: string | nulltime
totale uitvoeringstijd, seconden
- Type: string | nullversion
De huidige versie van de API
application/json - 400
Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
- 401
Een geldige Felo-API-sleutel is vereist.
- 402
Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
- 403
Het account mag deze bewerking niet uitvoeren.
- 429
Een verzoek- of bestedingslimiet is bereikt.
- 502
De dienst kon het verzoek niet voltooien.
- 503
De API of factureringsdienst is tijdelijk niet beschikbaar.
- 504
Er is een time-out opgetreden bij het verwerken van het verzoek.
- default
Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"internal_list_limit": 8,
"positive_connotation_threshold": 0.5
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"type": null,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}