v0.2.0-beta

OpenAPI 3.1.0

AI shrnutí v SERP API

Felo API Support

MIT

Server

https://openapi.felo.ai

Klientské knihovny

Shell Curl

DataForSEO

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

DataForSEO Operace

post/v1/beta/dataforseo/serp/ai_summary

AI shrnutí v SERP API

Vrací přehled AI, který Google zobrazuje nad výsledky pro dotaz v Google. Vrací keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count a items. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code — odmítnutý požadavek stále vrací HTTP 200.

Cenová reference

Účtování: nahlášené náklady na odpověď.
Referenční odhad požadavku: USD 0.02.
Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo

application/json

Typ: array (object | null)[]
- fetch_content
  Typ: boolean | null
  
  načítat obsah ze stránek ve výsledcích SERP
  volitelné pole
  pokud je nastaveno na true, API načte obsah ze stránek uvedených ve výsledcích SERP a model AI tento obsah zohlední při generování shrnutí ve výsledku;
  výchozí hodnota: false
- include_links
  Typ: boolean | null
  
  zahrnout odkazy na zdroje do shrnutí
  volitelné pole
  pokud je nastaveno na true, pole summary v odpovědi API bude obsahovat odkazy na zdroje vygenerovaného shrnutí;
  výchozí hodnota: false
- prompt
  Typ: string | null
  
  prompt pro AI
  volitelné pole
  dodatečná úloha pro shrnující AI;
  jakákoli forma textu, otázky nebo informace, která AI sděluje, jakou odpověď očekáváte;
  maximální počet symbolů nebo znaků, které můžete zadat: 2000;
  poznámka: váš prompt musí souviset s klíčovým slovem uvedeným v požadavku POST na SERP API
- support_extra
  Typ: boolean | null
  
  podporovat další funkce SERP
  volitelné pole
  pokud je nastaveno na true, model AI kromě výsledků organic zohlední následující další funkce SERP: answer_box, knowledge_graph, featured_snippet;
  výchozí hodnota: true
- task_id
  Typ: string
  
  identifikátor úlohy
  povinné pole
  jedinečný identifikátor přidružené úlohy ve formátu UUID
  můžete jej používat po dobu 30 dní a kdykoli požádat o výsledky úlohy

Odpovědi

200
Typ: object | null · Response36Afe1097B20_SerpAiSummaryResponseInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

status_code
Typ: integer | null

obecný kód stavu úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde

tasks
Typ: array (object | null)[] | null

pole úloh

Typ: object | null · Response36Afe1097B20_SerpAiSummaryTaskInfo
cost
Typ: number | null Formát: double

celkové náklady na úlohy, USD

data
Typ: object | null

obsahuje stejné parametry, které jste zadali v požadavku POST

propertyName
Typ: object | null
id
Typ: string | null

identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID

path
Typ: array (string | null)[] | null

cesta URL

result
Typ: array (object | null)[] | null

pole výsledků

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

pole položek

summary
Typ: string | null

vygenerované shrnutí
shrnutí vygenerované modelem AI podle parametrů uvedených v požadavku

items_count
Typ: integer | null Formát: int64

počet položek v poli výsledků

result_count
Typ: integer | null Formát: int64

počet prvků v poli result

status_code
Typ: integer | null

stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde

status_message
Typ: string | null

informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde

time
Typ: string | null

doba provedení, sekundy

tasks_count
Typ: integer | null Formát: int64

počet úloh v poli tasks

tasks_error
Typ: integer | null Formát: int64

počet úloh v poli tasks vrácených s chybou

time
Typ: string | null

celková doba provádění, sekundy

version
Typ: string | null

aktuální verze API
application/json
400

Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
401

Je vyžadován platný API klíč Felo.
402

V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
403

Účet nemá oprávnění tuto operaci provést.
429

Byl dosažen limit požadavků nebo útraty.
502

Služba nemohla požadavek dokončit.
503

API nebo fakturační služba je dočasně nedostupná.
504

Při zpracování požadavku vypršel časový limit služby.
default

Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

application/json

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
  }
]'

Zobrazit schéma

{
  "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
            }
          ]
        }
      ]
    }
  ]
}

Úspěšná operace

AI shrnutí v SERP API

OvěřováníRequired

DataForSEO

AI shrnutí v SERP API

Cenová reference