v0.2.0-beta

OpenAPI 3.1.0

Live-taken voor ‘DataForSEO Trends Subregion Interests’ instellen

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/keywords_data/dataforseo_trends/subregion_interests/live

Live-taken voor ‘DataForSEO Trends Subregion Interests’ instellen

Waar de interesse in een keyword geconcentreerd is, uitgesplitst naar subregio binnen location_code. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200. Voor het wie in plaats van het waar: post_dataforseo_keywords_trends_demography_live.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.0024.
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)[]
- date_from
  Type: string | null
  
  startdatum van de periode
  optioneel veld
  als je dit veld niet opgeeft, worden standaard de huidige dag en maand van het voorgaande jaar gebruikt
  minimumwaarde voor het type web: 2004-01-01
  minimumwaarde voor andere typen: 2008-01-01
  datumformaat: "yyyy-mm-dd"
  voorbeeld:
  "2019-01-15"
- date_to
  Type: string | null
  
  einddatum van de periode
  optioneel veld
  als je dit veld niet opgeeft, wordt standaard de datum van vandaag gebruikt
  datumformaat: "yyyy-mm-dd"
  voorbeeld:
  "2019-01-15"
- keywords
  Type: array string[]
  
  keywords
  verplicht veld
  maximaal aantal keywords dat u kunt opgeven: 5
  vermijd symbolen en speciale tekens (bijv. UTF-symbolen, emoji's);
  als u niet-Latijnse tekens opgeeft, ontvangt u gegevens voor de landen waar ze worden gebruikt
  
  meer informatie over regels en beperkingen van de velden keyword en keywords in DataForSEO-API's vindt u in dit Help Center-artikel
- location_code
  Type: integer | null
  
  locatiecode van de zoekmachine
  optioneel veld
  als u dit veld niet gebruikt, ontvangt u wereldwijde resultaten
  als u dit veld gebruikt, hoeft u location_name niet op te geven
  de lijst met beschikbare locaties van de zoekmachines en hun location_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
  let op: de gegevens worden geleverd voor het land waartoe de opgegeven location_code behoort;
  voorbeeld:
  2840
- location_name
  Type: string | null
  
  volledige naam van de zoekmachinelocatie
  optioneel veld
  als u dit veld niet gebruikt, ontvangt u wereldwijde resultaten
  als u dit veld gebruikt, hoeft u location_code niet op te geven
  de lijst met beschikbare locaties van de zoekmachine en hun location_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
  let op: de gegevens worden geleverd voor het land waartoe de opgegeven location_name behoort;
  voorbeeld:
  United Kingdom
- 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
- time_range
  Type: string | null
  
  vooraf ingestelde tijdsbereiken
  optioneel veld
  als u de parameters date_from of date_to opgeeft, wordt dit veld genegeerd bij het instellen van een taak
  mogelijke waarden voor alle type-parameters:
  past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years
- type
  Type: string | null
  
  elementtype

Responsen

200
Type: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveResponseInfo
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_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo
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

datetime
Type: string | null

datum en tijd waarop het resultaat is ontvangen
in UTC-indeling: “yyyy-mm-dd hh-mm-ss +00:00”
voorbeeld:
2019-11-15 12:57:46 +00:00

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

bevat keywordpopulariteit en gerelateerde gegevens

Type: object | null · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
Type: object · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
type
discriminator
Type: string | null

elementtype

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

subregionale populariteitsgegevens van keywords voor elke opgegeven term

keyword
Type: string | null

relevant keyword
de gegevens in het element values zijn gebaseerd op dit keyword

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

bevat gegevens over de relatieve keywordpopulariteit per land of regio

geo_id
Type: string | null

locatie-identificatie
je kunt dit veld gebruiken om de verkregen resultaten te koppelen aan de locatieparameters in het verzoek
bekijk de volledige lijst met beschikbare locaties met hun geo_id hier of via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
voorbeeld:
US-NY

geo_name
Type: string | null

locatienaam
je kunt dit veld gebruiken om de verkregen resultaten te koppelen aan de locatieparameters in het verzoek
bekijk de volledige lijst met beschikbare locaties met hun geo_name hier of via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
voorbeeld:
Andorra

value
Type: integer | null

relatieve populariteitsscore van het keyword op een bepaalde locatie
geeft de locatiespecifieke populariteitsscore van het keyword over het opgegeven tijdsbereik weer;
met deze value kunt u zien hoe populair een keyword op de ene locatie is vergeleken met een andere locatie;
berekening: we bepalen de hoogste populariteitswaarde voor het relevante keyword over alle locaties en drukken alle andere waarden uit als percentage van die hoogste waarde (100);
een waarde van 100 is de hoogste populariteit van de term
een waarde van 50 betekent dat de term half zo populair is
een waarde van 0 betekent dat er niet genoeg gegevens voor deze term waren

interests_comparison
Type: object | null · Response36Afe1097B20_InterestsComparison

vergelijking van gegevens over subregionale keywordpopulariteit voor de opgegeven parameters
als u één keyword hebt opgegeven, is de waarde null

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

populariteitsscores van keywords over alle locaties
de waarden in deze array zijn percentages ten opzichte van de maximale waarde over alle locaties

geo_id
Type: string | null

locatie-identificatie
je kunt dit veld gebruiken om de verkregen resultaten te koppelen aan de locatieparameters in het verzoek
bekijk de volledige lijst met beschikbare locaties met hun geo_id hier of via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
voorbeeld:
US-NY

geo_name
Type: string | null

locatienaam
je kunt dit veld gebruiken om de verkregen resultaten te koppelen aan de locatieparameters in het verzoek
bekijk de volledige lijst met beschikbare locaties met hun geo_name hier of via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
voorbeeld:
Andorra

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

bevat gegevens over de relatieve keywordpopulariteit per land of regio

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

bevat keywordpopulariteit en gerelateerde gegevens

geo_id
Type: string | null

locatie-identificatie
je kunt dit veld gebruiken om de verkregen resultaten te koppelen aan de locatieparameters in het verzoek
bekijk de volledige lijst met beschikbare locaties met hun geo_id hier of via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
voorbeeld:
US-NY

geo_name
Type: string | null

locatienaam
je kunt dit veld gebruiken om de verkregen resultaten te koppelen aan de locatieparameters in het verzoek
bekijk de volledige lijst met beschikbare locaties met hun geo_name hier of via een apart verzoek aan https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
voorbeeld:
Andorra

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

bevat gegevens over de relatieve keywordpopulariteit per land of regio

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

keywords in een POST-array

position
Type: integer | null

de uitlijning van het element
kan de volgende waarden hebben: 1, 2, 3, 4, enz.

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

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

keywords in een POST-array

language_code
Type: string | null

taalcode in een POST-array
als er geen gegevens zijn, is de waarde null

location_code
Type: integer | null

locatiecode in een POST-array
als er geen gegevens zijn, is de waarde null

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/keywords_data/dataforseo_trends/subregion_interests/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "interests": "[Max Depth Exceeded]",
              "interests_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

Live-taken voor ‘DataForSEO Trends Subregion Interests’ instellen

AuthenticatieRequired

DataForSEO

Live-taken voor ‘DataForSEO Trends Subregion Interests’ instellen

Prijsreferentie