v0.2.0-beta

OpenAPI 3.1.0

Content Analysis: categorietrends

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/category_trends/live

Content Analysis: categorietrends

Dezelfde metrieken per periode als post_dataforseo_content_phrase_trends_live, maar voor een hele productcategorie in plaats van één keyword. Haalt category_code uit get_dataforseo_content_categories, waarbij date_from, date_to en date_group het bereik en de granulariteit instellen, en retourneert per periode een date plus 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. Gebruik het om te zien hoe een markt beweegt in plaats van één frase; stap over op het frase-endpoint als je de exacte formulering al kent.

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)[]
- category_code
  Type: integer | null
  
  code van de doelcategorie
  verplicht veld
  een volledige lijst met beschikbare categorieën vindt u bij het endpoint Categories
- date_from
  Type: string
  
  begindatum van de periode
  verplicht veld
  minimumwaarde: 2022-10-31
  datumnotatie: "yyyy-mm-dd"
  voorbeeld:
  "2019-01-15"
- date_group
  Type: string | null
  
  periode waarmee de resultaten worden gegroepeerd
  optioneel veld
  standaardwaarde: month
  mogelijke waarden: day, week, month
- date_to
  Type: string | null
  
  einddatum van de periode
  optioneel veld
  als u dit veld niet opgeeft, wordt standaard de datum van vandaag gebruikt
  datumnotatie: "yyyy-mm-dd"
  voorbeeld:
  "2019-01-15"
- initial_dataset_filters
  Type: array (object | null)[] | null
  
  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 operator and of or
  de volgende operators worden ondersteund:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like,not_like, has, has_not, match, not_match
  met de operator % in like en not_like kunt u elke tekenreeks van nul of meer tekens matchen
  voorbeeld:
  ["domain","<>", "logitech.com"]
  
  [["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]]
  
  [["domain","<&gt","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
- internal_list_limit
  Type: integer | null
  
  maximaal aantal elementen in interne arrays
  optioneel veld
  met dit veld beperkt u het aantal elementen in de volgende arrays:
  top_domains
  text_categories
  page_categories
  countries
  languages
  standaardwaarde: 1
  maximale waarde: 20
- 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 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 gegevens over alle citaties voor de doel-category_code
  one_per_domain - retourneert gegevens over één citatie van de category_code 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_ContentAnalysisCategoryTrendsLiveResponseInfo
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_ContentAnalysisCategoryTrendsLiveTaskInfo
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

connotation_types
Type: object | null

connotatietypen
bevat typen sentimenten (sentimentpolariteit) met betrekking tot de vermelding van de categorie en het aantal vermeldingen per sentimenttype
mogelijke connotatietypen: "positive", "negative", "neutral"

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

countries
Type: object | null

landen
bevat landen en het aantal vermeldingen per land
raadpleeg het eindpunt Locations voor een volledige lijst met beschikbare landen

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

date
Type: string | null

datum waarvoor de gegevens worden verstrekt

languages
Type: object | null

talen
bevat talen en het aantal vermeldingen per taal
raadpleeg het eindpunt Languages voor een volledige lijst met beschikbare talen

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

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

paginacategorieën
bevat objecten met paginacategorieën en het aantal vermeldingen per paginacategorie
raadpleeg het eindpunt Categories voor een volledige lijst met beschikbare categorieën

category
Type: array (integer | null)[] | null
count
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

page_types
Type: object | null

paginatypen
bevat paginatypen en het aantal vermeldingen per paginatype

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

rank
Type: integer | null

rang van alle URL's die het keyword vermelden
genormaliseerde som van de rangen van alle URL's die het doel-keyword op de opgegeven datum vermelden

sentiment_connotations
Type: object | null

sentimentconnotaties
bevat sentimenten (emotionele reacties) met betrekking tot de vermelding van de doelcategorie en het aantal vermeldingen per sentiment
mogelijke connotaties: "anger", "fear", "happiness", "love", "sadness", "share", "neutral", "fun"

propertyName
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

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

tekstcategorieën
bevat objecten met tekstcategorieën en het aantal vermeldingen per tekstcategorie
raadpleeg het eindpunt Categories voor een volledige lijst met beschikbare categorieën

category
Type: array (integer | null)[] | null
count
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

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

topdomeinen die het doelkeyword vermelden
bevat objecten met topdomeinen die de doelcategorie vermelden en het aantal vermeldingen per domein

count
Type: integer | null Formaat: int64

Signed 64-bit integers (long type).

domain
Type: string | null
total_count
Type: integer | null Formaat: int64

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

type
Type: string | null

elementtype

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/category_trends/live

curl https://openapi.felo.ai/v1/beta/dataforseo/content_analysis/category_trends/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "category_code": 10994,
    "search_mode": "as_is",
    "date_from": "2022-09-01",
    "date_group": "month"
  }
]'

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": [
        {
          "type": null,
          "date": 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
        }
      ]
    }
  ]
}

Geslaagde bewerking

Content Analysis: categorietrends

AuthenticatieRequired

DataForSEO

Content Analysis: categorietrends

Prijsreferentie