v0.2.0-beta

OpenAPI 3.1.0

Taken voor Google App List 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/app_data/google/app_list/task_post

Taken voor Google App List instellen

Zet een van Google Plays eigen curated collecties - top free, top grossing, trending - gekozen met app_collection, in de wachtrij en retourneert een taak-id. depth beperkt hoe ver de ranglijst wordt gelezen. Asynchroon: submit retourneert een taak-id in tasks[0].id en de fetch-tool retourneert het resultaat zodra het klaar is. Haal op met get_dataforseo_app_google_app_list_fetch. Dit is de ranglijstweergave; voor een zoekopdracht op keyword gebruikt u post_dataforseo_app_google_app_searches_submit.

Prijsreferentie

Meting: Gerapporteerde antwoordkosten.
Referentieschatting per verzoek: USD 0.012.
Referentiemultiplier voor klanten: 1.0. Pas deze niet opnieuw toe op een al 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)[]
- age_rating
  Type: string | null
  
  resultaten filteren op leeftijdsclassificatie
  optioneel veld
  u kunt dit veld gebruiken om de resultaten op leeftijdsclassificatie te filteren;
  mogelijke filtertypen:
  ages_up_to_5 — apps retourneren die zijn goedgekeurd voor kinderen tot 5 jaar;
  ages_6_8 — apps retourneren die zijn goedgekeurd voor kinderen van 6 tot 8 jaar;
  ages_9_12 — apps retourneren die zijn goedgekeurd voor kinderen van 9 tot 12 jaar;
  standaard retourneert de API apps voor alle leeftijden;
  Let op: dit filter werkt alleen in combinatie met de parameter "category": "family"
- app_category
  Type: string | null
  
  app-categorie in Google Play
  optioneel veld
  u kunt de resultaten filteren op app-categorie;
  voorbeeld:
  family;
  de volledige lijst met beschikbare categorieën ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/app_data/google/categories
  Let op: app_category kan niet worden gebruikt als de parameter app_collection op featured is ingesteld
- app_collection
  Type: string
  
  app-collectie
  verplicht veld
  app-collectie in Google Play waaruit apps worden verzameld;
  u kunt de volgende waarden opgeven:
  featured, topselling_paid, topselling_free, topselling_new_free, topselling_new_paid, topgrossing, movers_shakers
  Let op: als featured is geselecteerd, kan de parameter app_category niet worden gebruikt
- depth
  Type: integer | null
  
  parseerdiepte
  optioneel veld
  aantal apps dat in de API-respons wordt geretourneerd;
  we raden sterk aan de parseerdiepte in veelvouden van 100 in te stellen, omdat ons systeem 100 resultaten achter elkaar verwerkt;
  standaardwaarde: 100;
  maximumwaarde: 200;
  Uw account wordt gefactureerd per SERP met maximaal 100 resultaten;
  een diepte boven 100 kan extra kosten veroorzaken als de zoekmachine meer dan 100 resultaten retourneert;
  de kosten kunnen worden berekend op de pagina Pricing.
- language_code
  Type: string
  
  taalcode van de zoekmachine
  verplicht veld als language_name niet is opgegeven
  als u dit veld gebruikt, hoeft u language_name niet op te geven
  de lijst met beschikbare talen met hun language_code_ ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/app_data/google/languages
  voorbeeld:
  en
- language_name
  Type: string
  
  volledige naam van de zoekmachinetaal
  verplicht veld als language_code niet is opgegeven
  als u dit veld gebruikt, hoeft u language_code niet op te geven
  de lijst met beschikbare talen met language_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/app_data/google/languages
  voorbeeld:
  English
- location_code
  Type: integer
  
  locatiecode van de zoekmachine
  verplicht veld als u location_name niet opgeeft
  als u dit veld gebruikt, hoeft u location_name niet op te geven
  de lijst met beschikbare locaties van de zoekmachine met hun location_code ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/app_data/google/locations
  voorbeeld:
  9061121
- location_name
  Type: string
  
  volledige naam van de zoekmachinelocatie
  verplicht veld als u location_code niet opgeeft
  als u dit veld gebruikt, hoeft u location_code niet op te geven
  de lijst met beschikbare locaties van de zoekmachine met hun location_name ontvangt u via een afzonderlijk verzoek aan https://api.dataforseo.com/v3/app_data/google/locations
  voorbeeld:
  West Los Angeles,California,United States
- pingback_url
  Type: string | null
  
  meldings-URL van een voltooide taak
  optioneel veld
  wanneer een taak is voltooid, informeren wij u via een GET-verzoek naar de URL die u hebt opgegeven
  u kunt de tekenreeks ‘$id’ gebruiken als $id-variabele en ‘$tag’ als url-gecodeerde $tag-variabele. Wij stellen de benodigde waarden in voordat het verzoek wordt verzonden.
  voorbeeld:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Let op: speciale tekens in pingback_url worden url-gecodeerd;
  zo wordt het teken # gecodeerd als %23
- postback_data
  Type: string
  
  postback_url-gegevenstype
  verplicht veld als u postback_url opgeeft
  komt overeen met het gegevenstype dat naar uw server wordt verzonden
  mogelijke waarden:
  advanced, html
- postback_url
  Type: string | null
  
  URL voor het verzenden van taakresultaten
  optioneel veld
  zodra de taak is voltooid, sturen wij een POST-verzoek met de resultaten, gecomprimeerd in de indeling gzip, naar de door u opgegeven postback_url
  u kunt de tekenreeks ‘$id’ gebruiken als $id-variabele en ‘$tag’ als url-gecodeerde $tag-variabele. Wij stellen de benodigde waarden in voordat het verzoek wordt verzonden.
  voorbeeld:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Let op: speciale tekens in postback_url worden url-gecodeerd;
  zo wordt het teken # gecodeerd als %23
- priority
  Type: integer | null
  
  taakprioriteit
  optioneel veld
  kan de volgende waarden hebben:
  1 – normale uitvoeringsprioriteit (standaard ingesteld)
  2 – hoge uitvoeringsprioriteit. Voor taken met een hoge uitvoeringsprioriteit wordt extra in rekening gebracht.
  De kosten kunnen worden berekend op de pagina Pricing.
- 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_AppDataGoogleAppListTaskPostResponseInfo
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_AppDataGoogleAppListTaskPostTaskInfo
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: object | null

array van resultaten
in dit geval is de waarde null

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/app_data/google/app_list/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/app_data/google/app_list/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_collection": "topselling_free",
    "location_code": 2840,
    "language_code": "en",
    "depth": 100
  }
]'

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": null
    }
  ]
}

Geslaagde bewerking

Taken voor Google App List instellen

AuthenticatieRequired

DataForSEO

Taken voor Google App List instellen

Prijsreferentie