API di SERP
L'azione search cerca pagine web per parola chiave e ne ottiene titoli, link, snippet, posizioni e date di pubblicazione per le applicazioni AI.
Ottieni risultati di ricerca web per parola chiave. Gli snippet non contengono il testo completo della pagina e non verificano i fatti.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su web e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 1 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di SERP: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Esegui una ricerca web e ottieni risultati ordinati con titolo, URL, snippet, posizione e data di pubblicazione. | $1.39 per 1.000 richieste | Normale |
Cosa accetta ogni azione di API di SERP?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Esegui una ricerca web e ottieni risultati ordinati con titolo, URL, snippet, posizione e data di pubblicazione. Un'immagine e i sottolink vengono restituiti quando presenti. | keyword | country, language | Valore del catalogo: maxLimit=10. Consulta le note dell'azione prima di considerarlo un numero finale di righe. Un limit più alto è accettato e ridotto a 10. | $1.39 per 1.000 richieste | title · url · text · rank · published_at · image_url · sub_links |
Cosa significano i parametri search di API di SERP?
Esegui una ricerca web e ottieni risultati ordinati con titolo, URL, snippet, posizione e data di pubblicazione. Un'immagine e i sottolink vengono restituiti quando presenti. country e language impostano preferenze ma non garantiscono che ogni risultato corrisponda. Le pagine non vengono recuperate per intero, e published_at può mancare o essere errato.
keywordObbligatorio- Indica l'espressione di ricerca web. Restituisce titoli, URL e snippet dei risultati; non recupera il contenuto completo delle pagine né filtra per nome della piattaforma.Google: snippet di ricerca e testo della pagina web di origine a confronto — Google definisce gli snippet come descrizioni o riepiloghi mostrati nei risultati di ricerca, e precisa che possono cambiare dinamicamente in base alla query o provenire dalla meta description della pagina. Il testo restituito da questa azione non è il testo completo della pagina di destinazione; quando citi dei fatti, controlla direttamente le pagine di origine verificate. · Verificato
countryFacoltativo- Imposta una preferenza di paese o regione per i risultati di ricerca tramite un codice come us. Influisce sulla rilevanza geografica, non sulla posizione del server chiamante, e non garantisce che ogni risultato si trovi in quel paese.
languageFacoltativo- Imposta la preferenza per la lingua dell'interfaccia di ricerca e dei risultati, ad es. en o zh-cn. Non traduce il contenuto delle pagine restituite.
Come usare l'API di SERP
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"web","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di SERP
Cosa posso ottenere con l'API di SERP?
Imposta platform su web. Il catalogo attuale elenca ricerca. Questi nomi di azione identificano oggetti o viste diversi di SERP; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di SERP?
Indica l'espressione di ricerca web. Restituisce titoli, URL e snippet dei risultati; non recupera il contenuto completo delle pagine né filtra per nome della piattaforma. Invialo come keyword all'interno di params.
Quali campi può restituire search di SERP?
Il suo schema dichiarato include title, text, rank e published_at. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di SERP rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.