v0.2.0-beta

OpenAPI 3.1.0

App Store: app-concurrenten (live)

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/apple/app_competitors/live

App Store: app-concurrenten (live)

App Store-apps die met een bepaalde app concurreren op gedeelde keywords. Paginering met limit, offset en offset_token; gebruik voorbij de eerste pagina's het token. Verpakt in de DataForSEO-envelop: data in tasks[0].result, uitkomst in tasks[0].status_code; een geweigerd verzoek retourneert nog steeds HTTP 200. Google Play-equivalent: post_dataforseo_labs_google_app_competitors_live.

Prijsreferentie

Afrekening: gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.1356.
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)[]
- app_id
  Type: string
  
  id van de app
  verplicht veld
  ID van de mobiele applicatie in de App Store;
  u vindt de ID in de URL van elke app die in de App Store wordt vermeld;
  voorbeeld:
  in de URL https://apps.apple.com/us/app/id835599320
  is de id 835599320
- 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:
  <, <=, >, >=, =, <>, in, not_in
  voorbeeld:
  ["intersections",">",500]
  
  [["competitor_metrics.app_store_search_organic.pos_1","<>",10],"and",["avg_position",">=","10"]]
  
  [[["intersections",">=",50],"and",["competitor_metrics.app_store_search_organic.pos_1","in",[1,5]]], "or", ["sum_position",">=","10000"]]
  
  meer informatie over filters vindt u bij Dataforseo Labs - Filters of in deze handleiding in het Help Center
  
  Leeg object
- language_code
  Type: string | null
  
  taalcode
  verplicht veld als u language_name niet opgeeft
  Let op: u moet language_name of language_code opgeven
  de lijst met beschikbare talen met language_code ontvangt u via een afzonderlijk verzoek aan
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Let op: dit endpoint ondersteunt momenteel alleen de Engelse taal
  voorbeeld:
  en
- language_name
  Type: string
  
  volledige naam van de taal
  verplicht veld als u language_code niet opgeeft
  Let op: u moet language_name of language_code opgeven
  de lijst met beschikbare talen met language_name ontvangt u via een afzonderlijk verzoek aan
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Let op: dit endpoint ondersteunt momenteel alleen de Engelse taal;
  voorbeeld:
  English
- limit
  Type: integer | null
  
  het maximale aantal teruggegeven apps
  optioneel veld
  standaardwaarde: 100
  maximale waarde: 1000
- location_code
  Type: integer
  
  locatiecode
  verplicht veld als u location_name niet opgeeft
  Let op: u moet location_name of location_code opgeven
  de lijst met beschikbare locaties met location_code ontvangt u via een afzonderlijk verzoek aan
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Let op: dit endpoint ondersteunt momenteel alleen de locatie VS;
  voorbeeld:
  2840
- location_name
  Type: string
  
  volledige naam van de locatie
  verplicht veld als u location_code niet opgeeft
  Let op: u moet location_name of location_code opgeven
  de lijst met beschikbare locaties met location_name ontvangt u via een afzonderlijk verzoek aan
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages;
  Let op: dit endpoint ondersteunt momenteel alleen de locatie VS;
  voorbeeld:
  United States
- offset
  Type: integer | null
  
  offset in de resultatenarray van geretourneerde apps
  optioneel veld
  standaardwaarde: 0
  als u de waarde 10 opgeeft, worden de eerste tien apps in de resultatenarray overgeslagen en worden de gegevens voor de volgende keywords 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;
  u stelt een sorteertype in met een komma;
  voorbeeld:
  ["intersections,asc"]
  Let op: u kunt per verzoek maximaal drie sorteerregels instellen;
  meerdere sorteerregels scheidt u met een komma;
  voorbeeld:
  ["intersections,desc","sum_position,asc"]
  
  standaardregel:
  ["intersections,desc"]
  Let op: als de array item_types itemtypen bevat die afwijken van organic, worden de resultaten geordend op het eerste itemtype in de array
- 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_DataforseoLabsAppleAppCompetitorsLiveResponseInfo
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_DataforseoLabsAppleAppCompetitorsLiveTaskInfo
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

app_id
Type: string | null

id van de app in een POST-array

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

bevat gegevens over de app_id en concurrerende apps

app_id
Type: string | null

id van de app in een POST-array

avg_position
Type: number | null Formaat: float

gemiddelde positie van de app in Google Play SERP
Opmerking: de gemiddelde positie wordt alleen berekend voor overlappende keywords;
de waarde voor een bepaalde applicatie kan afwijken in combinatie met andere doelapplicaties

competitor_metrics
Type: object | null

metrieken voor overlappende keywords
rankinggegevens voor de keywords die de opgegeven concurrerende applicatie deelt met de app in een POST-verzoek;
opmerking: in deze array worden rankinggegevens geleverd voor de app_id van de geretourneerde concurrent

propertyName
Type: object · Response36Afe1097B20_AppMetricsInfo
count
Type: integer | null Formaat: int64

totaal aantal organische Amazon SERP's dat het product bevat

pos_1
Type: integer | null

aantal organische SERP's waarin het product op #1 staat

pos_11_100
Type: integer | null

aantal organische SERP's waarin het product op #11-100 staat

pos_2_3
Type: integer | null

aantal organische SERP's waarin het product op #2-3 staat

pos_4_10
Type: integer | null

aantal organische SERP's waarin het product op #4-10 staat

search_volume
Type: integer | null Formaat: int64

totale zoekvolume van de rankingkeywords van het product in de organische SERP

full_metrics
Type: object | null

metrieken voor alle keywords van de applicatie
volledig overzicht van rankinggegevens voor alle keywords waarop de opgegeven app_id rankt

propertyName
Type: object · Response36Afe1097B20_AppMetricsInfo
count
Type: integer | null Formaat: int64

totaal aantal organische Amazon SERP's dat het product bevat

pos_1
Type: integer | null

aantal organische SERP's waarin het product op #1 staat

pos_11_100
Type: integer | null

aantal organische SERP's waarin het product op #11-100 staat

pos_2_3
Type: integer | null

aantal organische SERP's waarin het product op #2-3 staat

pos_4_10
Type: integer | null

aantal organische SERP's waarin het product op #4-10 staat

search_volume
Type: integer | null Formaat: int64

totale zoekvolume van de rankingkeywords van het product in de organische SERP

intersections
Type: integer | null

aantal overlappende keywords

se_type
Type: string | null

type zoekmachine

sum_position
Type: integer | null

som van alle app-posities in Google Play SERP
Opmerking: de sompositie wordt alleen berekend voor overlappende keywords;
de waarde voor een bepaalde applicatie kan afwijken in combinatie met andere doelapplicaties

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

location_code
Type: integer | null

locatiecode in een POST-array

se_type
Type: string | null

type zoekmachine

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/dataforseo_labs/apple/app_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/apple/app_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_id": "686449807",
    "language_name": "English",
    "location_code": 2840,
    "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": [
        {
          "se_type": null,
          "app_id": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "app_id": null,
              "avg_position": null,
              "sum_position": null,
              "intersections": null,
              "competitor_metrics": null,
              "full_metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

App Store: app-concurrenten (live)

AuthenticatieRequired

DataForSEO

App Store: app-concurrenten (live)

Prijsreferentie