v0.2.0-beta

OpenAPI 3.1.0

SERP-concurrenten

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/dataforseo_labs/google/serp_competitors/live

SERP-concurrenten

De domeinen die naast je ranken op een reeks keywords, met hoeveel ze gemeen hebben. Retourneert se_type, seed_keywords, total_count, items_count en items. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. ⚠️ Dit zijn zoekconcurrenten, bepaald door gedeelde rankings. Het linkgraaf-equivalent is post_dataforseo_backlinks_competitors_live, en de twee lijsten zijn het vaak oneens – wat op zichzelf informatief is.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.0192.
Referentieklantvermenigvuldiger: 1.0. Pas deze niet opnieuw toe op een afgerekend klantbedrag.

Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen 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 parameters voor het filteren van resultaten
  optioneel veld
  u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
  tussen de voorwaarden moet u een logische operator and, or plaatsen
  de volgende operators worden ondersteund:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
  met de operator % kunt u bij like en not_like, evenals ilike en not_ilike elke tekenreeks van nul of meer tekens matchen
  voorbeeld:
  ["median_position","in",[1,10]]
  
  [["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]]
  
  [["domain","not_like","%wikipedia.org%"], "and", [["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
  meer informatie over filters vindt u in Dataforseo Labs - Filters of in deze Help Center-gids
  
  Leeg object
- include_subdomains
  Type: boolean | null
  
  geeft aan of subdomeinen in de zoekopdracht worden opgenomen
  optioneel veld
  bij false worden subdomeinen genegeerd
  standaardwaarde: true
- item_types
  Type: array string[] | null
  
  type zoekresultaten
  geeft het type zoekresultaten aan dat in de respons is opgenomen
  optioneel veld
  
  mogelijke waarden:
  ["organic", "paid", "featured_snippet", "local_pack"]
  standaardwaarde:
  ["organic", "paid"]
- keywords
  Type: array string[]
  
  keywords-array
  verplicht veld
  de resultaten zijn gebaseerd op de keywords die u in deze array opgeeft
  UTF-8-codering;
  de keywords worden omgezet naar kleine letters;
  u kunt maximaal 200 keywords opgeven
  
  meer informatie over regels en beperkingen voor de velden keyword en keywords in DataForSEO-API's vindt u in dit Help Center-artikel
- language_code
  Type: string | null
  
  unieke taalidentificatie
  verplicht veld als niet opgegeven language_name
  Let op: u moet language_name of language_code opgeven
  de lijst met beschikbare talen en hun language_code-parameters ontvangt u via een apart verzoek aan de
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  voorbeeld:
  en
- language_name
  Type: string
  
  volledige naam van de taal
  verplicht veld als niet opgegeven language_code
  Let op: u moet language_name of language_code opgeven
  de lijst met beschikbare talen en hun language_name-parameters ontvangt u via een apart verzoek aan de
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  voorbeeld:
  English
- limit
  Type: integer | null
  
  maximaal aantal geretourneerde domeinen
  optioneel veld
  standaardwaarde: 100
  maximumwaarde: 1000
- location_code
  Type: integer
  
  unieke locatie-identificatie
  verplicht veld als niet opgegeven location_name
  Let op: u moet location_name of location_code opgeven
  de lijst met beschikbare locaties en hun location_code-parameters ontvangt u via een apart verzoek aan de
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  voorbeeld:
  2840
- location_name
  Type: string
  
  volledige naam van de locatie
  verplicht veld als niet opgegeven location_code
  Let op: u moet location_name of location_code opgeven
  de lijst met beschikbare locaties met location_name-parameters ontvangt u via een apart verzoek aan de
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  voorbeeld:
  United Kingdom
- offset
  Type: integer | null
  
  offset in de resultatenarray van geretourneerde domeinen
  optioneel veld
  standaardwaarde: 0
  als u de waarde 10 opgeeft, worden de eerste tien domeinen in de resultatenarray overgeslagen en worden de gegevens voor de volgende domeinen geleverd
- 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 in oplopende volgorde gesorteerd
  desc – resultaten worden in aflopende volgorde gesorteerd
  de komma wordt als scheidingsteken gebruikt
  voorbeeld:
  ["avg_position,asc"]
  standaardregel:
  ["rating,desc"]
  Let op: u kunt per verzoek maximaal drie sorteerregels instellen
  meerdere sorteerregels scheidt u met een komma
  voorbeeld:
  ["avg_position,asc","etv,desc"]
- 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_DataforseoLabsGoogleSerpCompetitorsLiveResponseInfo
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_DataforseoLabsGoogleSerpCompetitorsLiveTaskInfo
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 gedetecteerde SERP-concurrenten en gerelateerde gegevens

avg_position
Type: number | null Formaat: float

de gemiddelde positie van het domein voor de opgegeven keywords
het rekenkundig gemiddelde van de waarden in de array keywords_positions

domain
Type: string | null

domeinnaam van de gedetecteerde SERP-concurrent

etv
Type: number | null

geschat verkeersvolume
geeft het geschatte maandelijkse verkeer weer dat de opgegeven keywords naar de website sturen
berekend als de som van de producten van de zoekvolumewaarden van de opgegeven keywords en de CTR-waarden (click-through-rate) op bepaalde posities in SERP
lees meer over hoe de metriek wordt berekend in dit Help Center-artikel

keywords_count
Type: integer | null Formaat: int64

het aantal opgegeven keywords waarvoor het domein posities heeft in SERP's

keywords_positions
Type: object | null

keywordposities
SERP-posities die het gerelateerde domein inneemt in SERP voor de opgegeven keywords

propertyName
Type: array (integer | null)[] | null
median_position
Type: number | null

de mediane positie van het domein voor de opgegeven keywords
de mediaan van de waarden in de array keywords_positions

rating
Type: number | null

de marge tussen de maximaal mogelijke en de werkelijke keywordposities
geeft de relatieve zichtbaarheidsscore van het domein in SERP voor de opgegeven keywords weer
berekend als som(100-keywords_positions)

relevant_serp_items
Type: integer | null

het aantal SERP-elementen dat relevant is voor het domein
geeft het aantal zoekresultaten in SERP weer dat relevant is voor het domein voor de opgegeven keywords

se_type
Type: string | null

type zoekmachine

visibility
Type: number | null

SERP-zichtbaarheidsscore
geeft de zichtbaarheidsscore van de website weer op basis van de SERP-posities van de opgegeven keywords
Keywords met posities in het bereik van 1 tot 10 krijgen respectievelijk de zichtbaarheidsindex van 1 tot 0,1
Keywords met posities in het bereik van 11 tot 20 hebben de vaste zichtbaarheidsindex van 0,05
keywords met posities van 20 tot 100 hebben de zichtbaarheidsindex 0

items_count
Type: integer | null Formaat: int64

het aantal resultaten dat in de array items wordt geretourneerd

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

se_type
Type: string | null

type zoekmachine

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

keywords die in het verzoek zijn opgegeven
het keyword wordt geretourneerd met gedecodeerde %## (het plusteken '+' wordt gedecodeerd naar een spatie)

total_count
Type: integer | null Formaat: int64

het totale 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/dataforseo_labs/google/serp_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone"
    ],
    "language_name": "English",
    "location_code": 2840,
    "item_types": [
      "organic"
    ],
    "limit": 5
  }
]'

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": [
        {
          "se_type": null,
          "seed_keywords": [
            null
          ],
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "domain": null,
              "avg_position": null,
              "median_position": null,
              "rating": null,
              "etv": null,
              "keywords_count": null,
              "visibility": null,
              "relevant_serp_items": null,
              "keywords_positions": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

SERP-concurrenten

AuthenticatieRequired

DataForSEO

SERP-concurrenten

Prijsreferentie