v0.2.0-beta

OpenAPI 3.1.0

Content Analysis: zoeken

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operaties

post/v1/beta/dataforseo/content_analysis/search/live

Content Analysis: zoeken

Lijst de afzonderlijke pagina's die een keyword citeren, in plaats van de totalen. Elk item bevat url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score en page_category, naast total_count en items_count. filters accepteert de velden die get_dataforseo_content_available_filters vermeldt. Voor aantallen en verdelingen in plaats van pagina's gebruik je post_dataforseo_content_summary_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.

Body

application/json

Type: array (object | null)[]
- filters
  Type: array (object | null)[] | null
  
  array met filterparameters voor resultaten
  optioneel veld
  u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
  tussen de voorwaarden zet u een logische operator and of or
  de volgende operators worden ondersteund:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, match, not_match
  met de operator % in like en not_like kunt u elke tekenreeks van nul of meer tekens matchen
  voorbeeld:
  ["country","=", "US"]
  
  [["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]]
  
  [["domain_rank",">",800], "and", [["page_types","has","ecommerce"], "or",
  
  ["content_info.text_category","has",10994]]]
  meer informatie over filters vindt u in Content Analysis API - Filters
  
  Leeg object
- keyword
  Type: 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 keyword en keywords in DataForSEO-API's vindt u in dit Help Center-artikel
- keyword_fields
  Type: object | null
  
  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": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"
  
  propertyName
  Type: string | null
- limit
  Type: integer | null
  
  het maximale aantal teruggegeven citaties
  optioneel veld
  standaardwaarde: 100
  maximale waarde: 1000
- offset
  Type: integer | null
  
  offset in de resultatenarray van teruggegeven citaties
  optioneel veld
  standaardwaarde: 0
  als u de waarde 10 opgeeft, worden de eerste tien citaties in de resultatenarray overgeslagen en worden de gegevens voor de volgende citaties geleverd
  Let op: we raden aan deze parameter alleen te gebruiken bij het ophalen van maximaal 10.000 resultaten
  gebruik voor het ophalen van meer dan 10.000 resultaten in plaats daarvan offset_token.
- offset_token
  Type: string | null
  
  offset-token voor vervolgverzoeken
  optioneel veld
  wordt geleverd in het identieke veld van de respons op elk verzoek;
  gebruik deze parameter om time-outs te voorkomen bij het ophalen van meer dan 10.000 resultaten in één verzoek;
  door de unieke waarde offset_token uit de responsarray op te geven, ontvangt u de vervolgresultaten van de oorspronkelijke taak;
  offset_token-waarden zijn uniek voor elke vervolgtaak
  Let op: als offset_token in het verzoek wordt opgegeven, blijven alle andere parameters behalve limit buiten beschouwing bij de verwerking van een taak
  lees meer over deze parameter in ons Help Center
- order_by
  Type: array string[] | null
  
  sorteerregels voor resultaten
  optioneel veld
  u kunt dezelfde waarden als in de array filters gebruiken om de resultaten te sorteren
  mogelijke sorteertypen:
  asc - resultaten worden oplopend gesorteerd
  desc - resultaten worden aflopend gesorteerd
  sorteertype en -richting scheidt u met een komma
  voorbeeld:
  ["content_info.sentiment_connotations.anger,desc"]
  standaardregel:
  ["content_info.sentiment_connotations.anger,desc"]
  let op: u kunt per verzoek maximaal drie sorteerregels instellen
  meerdere sorteerregels scheidt u met een komma
  voorbeeld:
  ["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"]
- page_type
  Type: array string[] | null
  
  doeltypen pagina's
  optioneel veld
  met deze parameter filtert u de dataset op paginatypen
  mogelijke waarden:
  "ecommerce", "news", "blogs", "message-boards", "organization"
- rank_scale
  Type: string | null
  
  bepaalt de schaal die wordt gebruikt voor het berekenen en weergeven van de waarden domain_rank en url_rank
  optioneel veld
  
  met 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–100
  one_thousand — rangwaarden worden weergegeven op een schaal van 0–1000
  
  standaardwaarde: one_thousand
  
  lees meer over hoe deze parameter werkt in dit Help Center-artikel
- search_mode
  Type: string | null
  
  groeperingstype van de resultaten
  optioneel veld
  mogelijke groeperingstypen:
  as_is - retourneert alle citaties voor het doel-keyword
  one_per_domain - retourneert één citatie van het keyword per domein
  standaardwaarde: as_is
- tag
  Type: 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 waarde tag vind je in het data-object van de respons

Responsen

200
Type: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

status_code
Type: integer | null

algemene statuscode de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

algemeen informatief bericht de volledige lijst met algemene informatieve berichten vindt u hier

tasks
Type: array (object | null)[] | null

array van taken

Type: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveTaskInfo
cost
Type: number | null Formaat: double

Totale kosten van taken, USD

data
Type: object | null

Bevat dezelfde parameters die je in het POST-verzoek hebt opgegeven

propertyName
Type: object | null
id
Type: string | null

taak-id eenduidige taak-id in ons systeem in UUID-indeling

path
Type: array (string | null)[] | null

URL-pad

result
Type: array (object | null)[] | null

array van resultaten

items
Type: array (object | null)[] | null

bevat vermeldingen en gerelateerde gegevens

content_info
Type: object | null · Response36Afe1097B20_AnalysisContentInfo

bevat gegevens over vermeldingen uit de opgegeven url

author
Type: string | null

auteur van de inhoud

connotation_types
Type: object | null

connotatietypen
bevat typen sentimenten (sentimentpolariteit) die verband houden met het gegeven citaat en de waarschijnlijkheidsindex per sentimenttype
mogelijke connotatietypen: positive, negative, neutral

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

content_quality_score
Type: integer | null

score voor inhoudskwaliteit
deze waarde wordt berekend op basis van het aantal woorden, zinnen en tekens in de inhoud

content_type
Type: string | null

type inhoud
voorbeeld:
page_content, comment

date_published
Type: string | null

datum en tijd waarop de inhoud is gepubliceerd
in UTC-formaat: "yyyy-mm-dd hh-mm-ss +00:00"
voorbeeld:
2017-01-24 13:20:59 +00:00

group_date
Type: string | null

datum en tijd van de citatiegroep
geeft de publicatiedatum van de inhoud of de datum en tijd waarop onze crawler de pagina voor het eerst heeft bezocht;
dit veld kan worden gebruikt om citaties op datum te groeperen en citatietrends weer te geven;
datum en tijd worden gegeven in UTC-formaat: "yyyy-mm-dd hh-mm-ss +00:00"
voorbeeld:
2017-01-24 13:20:59 +00:00

highlighted_text
Type: string | null

gemarkeerde tekst uit het snippet

language
Type: string | null

hoofdtaal van het domein
raadpleeg het eindpunt Languages voor een volledige lijst met beschikbare talen

level
Type: integer | null

kopniveau van title
geeft het h-tagniveau aan van 1 (boven) tot 6 (onder)

main_title
Type: string | null

paginatitel

previous_title
Type: string | null

titel van het vorige inhoudsblok

rating
Type: object | null · Response36Afe1097B20_ContententRatingInfo

inhoudsbeoordeling
beoordeling met betrekking tot content_info

max_rating_value
Type: number | null Formaat: double

maximumwaarde voor de beoordelingsnaam

name
Type: string | null

beoordelingsnaam hier vindt u de volgende elementen: Max5, Percents, CustomMax

rating_count
Type: integer | null Formaat: int64

aantal stemmen

rating_value
Type: number | null Formaat: double

de waarde van de beoordeling

relative_rating
Type: number | null Formaat: double

relatieve beoordeling

semantic_location
Type: string | null

semantische locatie
geeft het semantische HTML-element aan waarin de citatie van het doelkeyword zich bevindt
voorbeeld:
article, header

sentiment_connotations
Type: object | null

sentimentconnotaties
bevat sentimenten (emotionele reacties) die verband houden met het gegeven citaat en de waarschijnlijkheidsindex per sentiment
mogelijke sentimentconnotaties: anger, happiness, love, sadness, share, fun

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

snippet
Type: string | null

inhoudssnippet

snippet_length
Type: integer | null

tekenlengte van het snippet

social_metrics
Type: array (object | null)[] | null

metrische gegevens over socialmedia-engagement
gegevens over socialmedia-interacties met de inhoud op basis van website-embeds die door socialmediaplatforms zijn ontwikkeld en ondersteund

like_count
Type: integer | null Formaat: int64

aantal likes

type
Type: string | null

elementtype

text_category
Type: array integer[] | null

tekstcategorie
voor een volledige lijst met beschikbare categorieën, zie het endpoint Categories

title
Type: string | null

titel van het resultaat

country
Type: string | null

landcode van de domeinregistratie
raadpleeg het eindpunt Locations voor een volledige lijst met beschikbare landen

domain
Type: string | null

domeinnaam

domain_rank
Type: integer | null

rang van het domain
deze waarde is gebaseerd op backlinkgegevens voor het opgegeven domein uit de DataForSEO Backlink Index;
domain_rank wordt berekend op basis van de methode voor node-ranking in een gekoppelde database – een principe uit het oorspronkelijke Google PageRank-algoritme
lees meer over deze metriek en hoe deze wordt berekend in dit Help Center-artikel

fetch_time
Type: string | null

datum en tijd waarop onze crawler de pagina heeft bezocht
in UTC-indeling: ‘yyyy-mm-dd hh-mm-ss +00:00’
voorbeeld:
2017-01-24 13:20:59 +00:00

language
Type: string | null

hoofdtaal van het domein
raadpleeg het eindpunt Languages voor een volledige lijst met beschikbare talen

main_domain
Type: string | null

hoofddomein

page_category
Type: array integer[] | null

bevat alle relevante paginacategorieën
product- en dienstcategorieën die relevant zijn voor de pagina
raadpleeg het eindpunt Categories voor een volledige lijst met beschikbare categorieën

page_types
Type: array string[] | null

paginatypen

ratings
Type: array (object | null)[] | null

op de pagina gevonden beoordelingen
alle op de pagina gevonden beoordelingen op basis van microdata

max_rating_value
Type: number | null Formaat: double

maximumwaarde voor de beoordelingsnaam

name
Type: string | null

beoordelingsnaam hier vindt u de volgende elementen: Max5, Percents, CustomMax

rating_count
Type: integer | null Formaat: int64

aantal stemmen

rating_value
Type: number | null Formaat: double

de waarde van de beoordeling

relative_rating
Type: number | null Formaat: double

relatieve beoordeling

score
Type: number | null

prominentiescore van de vermelding
deze waarde is gebaseerd op url_rank, domain_rank, aanwezigheid van keyword in title, main_title, url, snippet
hoe hoger de score, hoe waardevoller de bijbehorende vermelding

social_metrics
Type: array (object | null)[] | null

metrische gegevens over socialmedia-engagement
gegevens over socialmedia-interacties met de inhoud op basis van website-embeds die door socialmediaplatforms zijn ontwikkeld en ondersteund

like_count
Type: integer | null Formaat: int64

aantal likes

type
Type: string | null

elementtype

spam_score
Type: integer | null

spamscore van backlinks van de url
deze waarde is gebaseerd op backlinkgegevens voor de opgegeven URL uit de DataForSEO Backlink Index;
lees meer over hoe deze metriek wordt berekend op deze Help Center-pagina

type
Type: string | null

elementtype

url
Type: string | null

URL waar de vermelding is gevonden

url_rank
Type: integer | null

rang van de url
deze waarde is gebaseerd op backlinkgegevens voor de opgegeven URL uit de DataForSEO Backlink Index;
url_rank wordt berekend op basis van de methode voor node-ranking in een gekoppelde database – een principe uit het oorspronkelijke Google PageRank-algoritme
lees meer over deze metriek en hoe deze wordt berekend in dit Help Center-artikel

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

offset_token
Type: string | null

offsettoken voor vervolgaanvragen
u kunt de tekenreeks in dit veld gebruiken om de vervolgresultaten van de oorspronkelijke taak op te halen;
opmerking: offset_token-waarden zijn uniek voor elke vervolgtaak

total_count
Type: integer | null Formaat: int64

totaal aantal resultaten in onze database dat relevant is voor uw verzoek

result_count
Type: integer | null Formaat: int64

Aantal elementen in de result-array

status_code
Type: integer | null

statuscode van de taak gegenereerd door DataForSEO, kan binnen het volgende bereik liggen: 10000-60000 de volledige lijst met responscodes vindt u hier

status_message
Type: string | null

informatief bericht van de taak de volledige lijst met algemene informatieve berichten vindt u hier

time
Type: string | null

Uitvoeringstijd in seconden

tasks_count
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array

tasks_error
Type: integer | null Formaat: int64

Het aantal taken in de tasks-array dat met een fout is geretourneerd

time
Type: string | null

totale uitvoeringstijd, seconden

version
Type: string | null

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

post/v1/beta/dataforseo/content_analysis/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword_fields": {
      "snippet": "logitech"
    },
    "keyword": "logitech",
    "page_type": [
      "ecommerce",
      "news",
      "blogs",
      "message-boards",
      "organization"
    ],
    "search_mode": "as_is",
    "filters": [
      "main_domain",
      "=",
      "reviewfinder.ca"
    ],
    "order_by": [
      "content_info.sentiment_connotations.anger,desc"
    ],
    "limit": 10
  }
]'

Schema tonen

{
  "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": [
        {
          "offset_token": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "url": null,
              "domain": null,
              "main_domain": null,
              "url_rank": null,
              "spam_score": null,
              "domain_rank": null,
              "fetch_time": null,
              "country": null,
              "language": null,
              "score": null,
              "page_category": [
                "[Max Depth Exceeded]"
              ],
              "page_types": [
                "[Max Depth Exceeded]"
              ],
              "ratings": [
                "[Max Depth Exceeded]"
              ],
              "social_metrics": [
                "[Max Depth Exceeded]"
              ],
              "content_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Content Analysis: zoeken

AuthenticatieRequired

DataForSEO

Content Analysis: zoeken

Prijsreferentie