Felo API PlatformFelo API Platform
Tutti gli endpoint di DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Backlink

Felo API Support
MIT
Server:https://openapi.felo.ai
Librerie client
Shell Curl

DataForSEO

​

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

DataForSEO Operazioni

Backlink

​

I singoli link in entrata verso un target, una riga per link. Restituisce total_count, items_count, items e un search_after_token per la paginazione: usarlo al posto di offset oltre le prime pagine. mode e custom_mode controllano il raggruppamento, backlinks_status_type seleziona live, lost o all. Per i conteggi anziché le righe usare post_dataforseo_backlinks_summary_live; per i domini che linkano raggruppati, post_dataforseo_backlinks_referring_domains_live.

Riferimento prezzi

  • Misurazione: costo della risposta riportato.
  • Stima di riferimento per richiesta: USD 0.06.
  • Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo cliente già addebitato.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo
application/json
  • Tipo: array (object | null)[]
    • backlinks_status_type
      Tipo: string | null

      impostare quali backlink restituire e conteggiare
      campo facoltativo
      è possibile usare questo campo per scegliere quali backlink verranno restituiti e usati per le metriche aggregate del target;
      valori possibili:
      all - tutti i backlink verranno restituiti e conteggiati;
      live - i backlink trovati durante l'ultimo controllo verranno restituiti e conteggiati;
      lost - i backlink persi verranno restituiti e conteggiati;

      valore predefinito: live

    • custom_mode
      Tipo: object | null

      tipo di raggruppamento dei risultati dettagliati
      campo facoltativo
      usare questo oggetto per ottenere un numero specifico di backlink per field
      se si usa custom_mode, mode verrà ignorato
      esempio:
      "custom_mode": {"field": "domain", "value": 100}

      • propertyName
        Tipo: object | null
    • exclude_internal_backlinks
      Tipo: boolean | null

      indica se i backlink interni dai sottodomini al target verranno esclusi dai risultati
      campo facoltativo
      se impostato su true, i risultati non includeranno dati sui backlink interni dai sottodomini dello stesso dominio del target
      se impostato su false, i link interni verranno inclusi nei risultati
      valore predefinito: true

    • filters
      Tipo: array (object | null)[] | null

      array di parametri di filtro dei risultati
      campo facoltativo
      è possibile aggiungere più filtri contemporaneamente (massimo 8 filtri)
      tra le condizioni impostare un operatore logico and o or
      sono supportati i seguenti operatori:
      =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
      con l'operatore % in like e not_like è possibile trovare corrispondenze con qualsiasi stringa di zero o più caratteri
      esempio:
      ["rank",">","80"]

      [["page_from_rank",">","55"],
      "and",
      ["dofollow","=",true]]

      [["first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]

      l'elenco completo dei filtri possibili è disponibile qui.

      Oggetto vuoto
    • include_subdomains
      Tipo: boolean | null

      indica se i sottodomini del target verranno inclusi nella ricerca
      campo facoltativo
      se impostato su false, i sottodomini verranno ignorati
      valore predefinito: true

    • limit
      Tipo: integer | null

      il numero massimo di backlink restituiti
      campo facoltativo

      valore predefinito: 100
      valore massimo: 1000

    • mode
      Tipo: string | null

      tipo di raggruppamento dei risultati
      campo facoltativo
      tipi di raggruppamento possibili:
      as_is - restituisce tutti i backlink
      one_per_domain - restituisce un backlink per dominio
      one_per_anchor - restituisce un backlink per anchor

      valore predefinito: as_is

    • offset
      Tipo: integer | null

      offset nell'array dei risultati dei backlink restituiti
      campo facoltativo

      valore predefinito: 0
      se si specifica il valore 10, i primi dieci backlink nell'array dei risultati verranno saltati e i dati verranno forniti per i backlink successivi;
      Nota: il valore massimo è 20,000; se si desidera scorrere più risultati, usare search_after_token

    • order_by
      Tipo: array string[] | null

      regole di ordinamento dei risultati
      campo facoltativo
      è possibile usare gli stessi valori dell'array filters per ordinare i risultati
      tipi di ordinamento possibili:
      asc - i risultati vengono ordinati in ordine crescente
      desc - i risultati vengono ordinati in ordine decrescente
      il tipo di ordinamento si imposta con una virgola
      esempio:
      ["rank,desc"]
      nota: è possibile impostare al massimo tre regole di ordinamento per richiesta
      per separare più regole di ordinamento usare una virgola
      esempio:
      ["domain_from_rank,desc","page_from_rank,asc"]

    • rank_scale
      Tipo: string | null

      definisce la scala utilizzata per calcolare e visualizzare i valori rank, domain_from_rank e page_from_rank
      campo facoltativo

      con questo parametro si sceglie se i valori di rank vengono presentati su una scala 0–100 o 0–1000

      valori possibili:
      one_hundred — i valori di rank vengono visualizzati su una scala 0–100
      one_thousand — i valori di rank vengono visualizzati su una scala 0–1000

      valore predefinito: one_thousand

      scopri di più sul funzionamento di questo parametro e sul calcolo delle metriche di ranking in questo articolo del Help Center

    • search_after_token
      Tipo: string | null

      token per le richieste successive
      campo facoltativo
      fornito nel campo identico della risposta a ogni richiesta;
      usare questo parametro per evitare timeout quando si cercano più di 20,000 risultati in un'unica richiesta;
      specificando il valore univoco search_after_token dell'array di risposta, si ottengono i risultati successivi dell'attività iniziale;
      i valori search_after_token sono univoci per ogni attività successiva;
      Nota: se nella richiesta è specificato search_after_token, tutti gli altri parametri devono essere identici alla richiesta precedente

    • tag
      Tipo: string | null

      identificatore dell'attività definito dall'utente
      campo facoltativo
      il limite di caratteri è 255
      puoi usare questo parametro per identificare l'attività e associarla al risultato
      il valore tag specificato si trova nell'oggetto data della risposta

    • target
      Tipo: string

      dominio, sottodominio o pagina web per cui ottenere i backlink
      campo obbligatorio
      un dominio o un sottodominio va specificato senza https:// e www.
      una pagina va specificata con URL assoluto (inclusi http:// o https://)

Risposte
  • 200
    Tipo: object | null · Response36Afe1097B20_BacklinksBacklinksLiveResponseInfo
    • cost
      Tipo: number | null Formato: double

      Costo totale delle attività, USD

    • status_code
      Tipo: integer | null

      codice di stato generale l'elenco completo dei codici di risposta è disponibile qui

    • status_message
      Tipo: string | null

      messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui

    • tasks
      Tipo: array (object | null)[] | null

      array di attività

      • Tipo: object | null · Response36Afe1097B20_BacklinksBacklinksLiveTaskInfo
        • cost
          Tipo: number | null Formato: double

          Costo totale delle attività, USD

        • data
          Tipo: object | null

          Contiene gli stessi parametri specificati nella richiesta POST

          • propertyName
            Tipo: object | null
        • id
          Tipo: string | null

          identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID

        • path
          Tipo: array (string | null)[] | null

          Percorso URL

        • result
          Tipo: array (object | null)[] | null

          array di risultati

          • custom_mode
            Tipo: object | null

            modalità personalizzata specificata in un array POST

            • propertyName
              Tipo: object | null
          • items
            Tipo: array (object | null)[] | null

            contiene i dati pertinenti su backlink e domini di riferimento

            • alt
              Tipo: string | null

              testo alternativo dell'immagine
              questo campo sarà null se il type del backlink non è image

            • anchor
              Tipo: string | null

              testo ancora del backlink

            • attributes
              Tipo: array (string | null)[] | null

              attributi del link dei link di riferimento
              esempio:
              nofollow

            • backlink_spam_score
              Tipo: integer | null

              punteggio spam del backlink
              scopri di più su come viene calcolata questa metrica in questa pagina del Help Center

            • dofollow
              Tipo: boolean | null

              indica se il backlink è dofollow
              se è false, il backlink è nofollow

            • domain_from
              Tipo: string | null

              dominio che fa riferimento al dominio o alla pagina web di destinazione

            • domain_from_country
              Tipo: string | null

              codice paese ISO del dominio di riferimento

            • domain_from_ip
              Tipo: string | null

              indirizzo IP del dominio di riferimento

            • domain_from_is_ip
              Tipo: boolean | null

              indica se il dominio è un IP
              se è true, il dominio funziona come indirizzo IP e non ha un nome di dominio

            • domain_from_platform_type
              Tipo: array (string | null)[] | null

              tipi di piattaforma del dominio di riferimento

              valori possibili: cms, blogs, ecommerce, message-boards, wikis, news, organization

            • domain_from_rank
              Tipo: integer | null

              rank del dominio del dominio di riferimento
              domain_from_rank viene calcolato in base al metodo di ranking dei nodi in un database collegato, un principio dell'originale algoritmo Google PageRank
              scopri di più su questa metrica e su come viene calcolata in questo articolo del Help Center

            • domain_to
              Tipo: string | null

              dominio a cui punta il backlink

            • first_seen
              Tipo: string | null

              data e ora in cui il nostro crawler ha trovato il backlink per la prima volta
              in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              esempio:
              2019-11-15 12:57:46 +00:00

            • group_count
              Tipo: integer | null Formato: int64

              indica il numero totale di backlink da questo dominio
              ad esempio, se mode è impostato su one_per_domain, questo campo indica il numero totale di backlink provenienti da questo dominio

            • image_url
              Tipo: string | null

              URL dell'immagine
              l'URL che porta all'immagine sulla risorsa originale o nello storage DataForSEO (nel caso la fonte originale non sia disponibile)

            • indirect_link_path
              Tipo: array (object | null)[] | null

              percorso del link indiretto
              indica un URL o una sequenza di URL che portano a url_to

              • status_code
                Tipo: integer | null

                codice di stato generale
                l'elenco completo dei codici di risposta è disponibile qui
                Nota: consigliamo vivamente di progettare un sistema adeguato per gestire le relative condizioni eccezionali o di errore

              • type
                Tipo: string | null

                tipo di elemento

              • url
                Tipo: string | null

                URL del link indiretto

            • is_broken
              Tipo: boolean | null

              indica se il backlink è interrotto
              se è true, il backlink punta a una pagina che risponde con un codice di stato 4xx o 5xx

            • is_indirect_link
              Tipo: boolean | null

              indica se il backlink è un link indiretto
              se è true, il backlink è un link indiretto che punta a una pagina che reindirizza a url_to o punta a una pagina canonica

            • is_lost
              Tipo: boolean | null

              indica se il backlink è stato rimosso
              se è true, sono stati rimossi il backlink o l'intera pagina

            • is_new
              Tipo: boolean | null

              indica se il backlink è nuovo
              se è true, il backlink è stato trovato sulla pagina durante l'ultima visita del nostro crawler

            • item_type
              Tipo: string | null

              tipo di link
              valori possibili:
              anchor, image, meta, canonical, alternate, redirect

            • last_seen
              Tipo: string | null

              data più recente in cui il nostro crawler ha visitato il backlink
              in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              esempio:
              2019-11-15 12:57:46 +00:00

            • links_count
              Tipo: integer | null Formato: int64

              numero di backlink identici trovati sulla pagina di riferimento

            • original
              Tipo: boolean | null

              indica se il backlink era presente sulla pagina di riferimento quando il nostro crawler l'ha visitata per la prima volta

            • page_from_encoding
              Tipo: string | null

              codifica dei caratteri della pagina di riferimento
              esempio:
              utf-8

            • page_from_external_links
              Tipo: integer | null

              numero di link esterni trovati sulla pagina di riferimento

            • page_from_internal_links
              Tipo: integer | null

              numero di link interni trovati sulla pagina di riferimento

            • page_from_language
              Tipo: string | null

              lingua della pagina di riferimento
              in formato ISO 639-1
              esempio:
              en

            • page_from_rank
              Tipo: integer | null

              rank della pagina di riferimento
              page_from_rank viene calcolato in base al metodo di ranking dei nodi in un database collegato, un principio dell'originale algoritmo Google PageRank
              scopri di più su questa metrica e su come viene calcolata in questo articolo del Help Center

            • page_from_size
              Tipo: integer | null

              dimensione della pagina di riferimento, in byte
              esempio:
              63357

            • page_from_status_code
              Tipo: integer | null

              codice di stato HTTP restituito dalla pagina di riferimento
              esempio:
              200

            • page_from_title
              Tipo: string | null

              titolo della pagina di riferimento

            • prev_seen
              Tipo: string | null

              precedente alla data più recente in cui il nostro crawler ha visitato il backlink
              in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              esempio:
              2019-11-15 12:57:46 +00:00

            • rank
              Tipo: integer | null

              rank del backlink
              rank che il backlink in questione trasmette al target
              rank viene calcolato in base al metodo di ranking dei nodi in un database collegato, un principio dell'originale algoritmo Google PageRank
              scopri di più su questa metrica e su come viene calcolata in questo articolo del Help Center

            • ranked_keywords_info
              Tipo: object | null · Response36Afe1097B20_RankedKeywordsInfo
              • page_from_keywords_count_top_10
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_100
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

              • page_from_keywords_count_top_3
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • semantic_location
              Tipo: string | null

              indica l'elemento HTML semantico in cui è stato trovato il backlink
              l'elenco completo degli elementi semantici è disponibile qui
              esempi:
              article, section, summary

            • text_post
              Tipo: string | null

              snippet dopo il testo ancora

            • text_pre
              Tipo: string | null

              snippet prima del testo ancora

            • tld_from
              Tipo: string | null

              dominio di primo livello dell'URL di riferimento

            • type
              Tipo: string | null

              tipo di elemento

            • url_from
              Tipo: string | null

              URL della pagina in cui è stato trovato il backlink

            • url_from_https
              Tipo: boolean | null

              indica se l'URL di riferimento è protetto con HTTPS
              se è true, l'URL di riferimento è protetto con HTTPS

            • url_to
              Tipo: string | null

              URL a cui punta il backlink

            • url_to_https
              Tipo: boolean | null

              indica se l'URL a cui punta il backlink è protetto con HTTPS
              se è true, l'URL è protetto con HTTPS

            • url_to_redirect_target
              Tipo: string | null

              URL di destinazione del redirect
              pagina di destinazione a cui punta il redirect

            • url_to_spam_score
              Tipo: integer | null

              punteggio spam della pagina di riferimento
              se il valore è null, il nostro crawler non ha ancora visitato la pagina web a cui punta il link;
              scopri di più su come viene calcolata questa metrica in questa pagina del Help Center

            • url_to_status_code
              Tipo: integer | null

              codice di stato della pagina di destinazione
              se il valore è null, il nostro crawler non ha ancora visitato la pagina web a cui punta il link
              esempio:
              200

          • items_count
            Tipo: integer | null Formato: int64

            il numero di risultati restituiti nell'array items

          • mode
            Tipo: string | null

            modalità specificata in un array POST

          • search_after_token
            Tipo: string | null

            token per le richieste successive
            specificando l'search_after_token univoco durante l'impostazione di una nuova attività, si ottengono i risultati successivi dell'attività iniziale;
            i valori di search_after_token sono univoci per ogni attività successiva

          • target
            Tipo: string | null

            dominio di destinazione in un array POST

          • total_count
            Tipo: integer | null Formato: int64

            numero totale di risultati pertinenti alla richiesta

        • result_count
          Tipo: integer | null Formato: int64

          Numero di elementi nell'array dei risultati

        • status_code
          Tipo: integer | null

          codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui

        • status_message
          Tipo: string | null

          messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui

        • time
          Tipo: string | null

          Tempo di esecuzione in secondi

    • tasks_count
      Tipo: integer | null Formato: int64

      Il numero di attività nell'array tasks

    • tasks_error
      Tipo: integer | null Formato: int64

      Il numero di attività nell'array tasks restituite con un errore

    • time
      Tipo: string | null

      tempo di esecuzione totale, secondi

    • version
      Tipo: string | null

      La versione corrente dell'API

    application/json
  • 400

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

    application/json
Request Example for post/v1/beta/dataforseo/backlinks/backlinks/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "mode": "as_is",
    "filters": [
      "dofollow",
      "=",
      true
    ],
    "limit": 5
  }
]'

{
  "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": [
        {
          "target": null,
          "mode": null,
          "custom_mode": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain_from": null,
              "url_from": null,
              "url_from_https": null,
              "domain_to": null,
              "url_to": null,
              "url_to_https": null,
              "tld_from": null,
              "is_new": null,
              "is_lost": null,
              "backlink_spam_score": null,
              "rank": null,
              "page_from_rank": null,
              "domain_from_rank": null,
              "domain_from_platform_type": [
                "[Max Depth Exceeded]"
              ],
              "domain_from_is_ip": null,
              "domain_from_ip": null,
              "domain_from_country": null,
              "page_from_external_links": null,
              "page_from_internal_links": null,
              "page_from_size": null,
              "page_from_encoding": null,
              "page_from_language": null,
              "page_from_title": null,
              "page_from_status_code": null,
              "first_seen": null,
              "prev_seen": null,
              "last_seen": null,
              "item_type": null,
              "attributes": [
                "[Max Depth Exceeded]"
              ],
              "dofollow": null,
              "original": null,
              "alt": null,
              "image_url": null,
              "anchor": null,
              "text_pre": null,
              "text_post": null,
              "semantic_location": null,
              "links_count": null,
              "group_count": null,
              "is_broken": null,
              "url_to_status_code": null,
              "url_to_spam_score": null,
              "url_to_redirect_target": null,
              "ranked_keywords_info": "[Max Depth Exceeded]",
              "is_indirect_link": null,
              "indirect_link_path": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "search_after_token": null
        }
      ]
    }
  ]
}

Operazione riuscita

Backlinks