Felo API PlatformFelo API Platform
Alle endpoints van DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

SERP-API: AI-samenvatting

Server:https://openapi.felo.ai
Clientbibliotheken

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

SERP-API: AI-samenvatting

​

Retourneert het AI-overzicht dat Google boven de resultaten toont voor een zoekopdracht op Google. Retourneert keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count en items. Verpakt in de DataForSEO-envelop: gegevens in tasks[0].result, uitkomst in tasks[0].status_code – een geweigerd verzoek retourneert nog steeds HTTP 200.

Prijsreferentie

  • Metering: Gerapporteerde responskosten.
  • Referentieschatting per verzoek: USD 0.02.
  • 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)[]
    • fetch_content
      Type: boolean | null

      inhoud van pagina's in SERP's ophalen
      optioneel veld
      bij true haalt de API de inhoud op van pagina's die in SERP-resultaten voorkomen, en het AI-model neemt deze inhoud mee bij het genereren van de samenvatting in het resultaat;
      standaardwaarde: false

    • include_links
      Type: boolean | null

      bronlinks in de samenvatting opnemen
      optioneel veld
      bij true bevat het veld summary in de API-respons links naar de bronnen van de gegenereerde samenvatting;
      standaardwaarde: false

    • prompt
      Type: string | null

      AI-prompt
      optioneel veld
      aanvullende taak voor de AI-samenvatter;
      elke vorm van tekst, vraag of informatie die de AI duidelijk maakt welke reactie u zoekt;
      maximaal aantal symbolen of tekens dat u kunt opgeven: 2000;
      let op: uw prompt moet relevant zijn voor het keyword dat in het POST-verzoek aan de SERP API is opgegeven

    • support_extra
      Type: boolean | null

      extra SERP-functies ondersteunen
      optioneel veld
      bij true neemt het AI-model naast de organic-resultaten de volgende extra SERP-functies mee: answer_box, knowledge_graph, featured_snippet;
      standaardwaarde: true

    • task_id
      Type: string

      taak-ID
      verplicht veld
      unieke identifier van de bijbehorende taak in UUID-formaat
      u kunt deze 30 dagen lang gebruiken om op elk moment de resultaten van de taak op te vragen

Responsen
  • 200
    Type: object | null · Response36Afe1097B20_SerpAiSummaryResponseInfo
    • 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_SerpAiSummaryTaskInfo
        • 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

            items-array

            • summary
              Type: string | null

              gegenereerde samenvatting
              samenvatting die door het AI-model is gegenereerd op basis van de in de aanvraag opgegeven parameters

          • items_count
            Type: integer | null Formaat: int64

            aantal items in de resultatenarray

        • 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
Request Example for post/v1/beta/dataforseo/serp/ai_summary
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/ai_summary \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "task_id": "07031739-1535-0139-0000-9d1e639a5b7d",
    "prompt": "explain what DataForSEO is",
    "include_links": true,
    "fetch_content": true
  }
]'
{
  "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": [
        {
          "items_count": null,
          "items": [
            {
              "summary": null
            }
          ]
        }
      ]
    }
  ]
}
SERP API AI Summary