v0.2.0-beta

OpenAPI 3.1.0

OnPage API: bronnen

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/on_page/resources

OnPage API: bronnen

De niet-pagina-assets die een crawl vond – afbeeldingen, scripts, stylesheets – met hun statuscodes en groottes. Pagina's met search_after_token. Leest een voltooide crawl en heeft dus de id uit post_dataforseo_on_page_submit nodig; retourneert crawl_progress plus een crawl_status van max_crawl_pages, pages_in_queue en pages_crawled – controleer die voordat je een klein resultaat vertrouwt, want een crawl die nog loopt heeft eenvoudigweg minder te melden. Gebruik voor de assets die de crawler helemaal niet kon bereiken post_dataforseo_on_page_uncrawlable_resources. 💰 Gratis upstream: een voltooide crawl bevragen kost niets, alleen de crawl zelf.

Prijsreferentie

Metering: Gerapporteerde responskosten.
Referentieschatting per verzoek: USD 0.012.
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)[]
- filters
  Type: array (object | null)[] | null
  
  array met parameters voor het filteren van resultaten
  optioneel veld
  u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
  u moet tussen de voorwaarden een logische operator and, or plaatsen
  de volgende operatoren worden ondersteund:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  u kunt de operator % met like en not_like gebruiken om elke tekenreeks van nul of meer tekens te matchen
  voorbeeld:
  ["resource_type","=","stylesheet"]
  
  [["resource_type","=","image"], "and",["checks.is_https","=",false]]
  
  [["fetch_timing.duration_time",">",1],"and",[["total_transfer_size",">",100],"or",["checks.high_loading_time","=",true]]]
  
  de volledige lijst met mogelijke filters vindt u via deze link.
  
  Leeg object
- id
  Type: string
  
  ID van de taak
  verplicht veld
  deze ID vindt u in de respons van het endpoint Task POST
  voorbeeld:
  "07131248-1535-0216-1000-17384017ad04"
- limit
  Type: integer | null
  
  het maximale aantal geretourneerde bronnen
  optioneel veld
  standaardwaarde: 100
  maximale waarde: 1000
- offset
  Type: integer | null
  
  offset in de resultatenarray van geretourneerde bronnen
  optioneel veld
  standaardwaarde: 0
  maximale waarde: 2000000
  als u de waarde 10 opgeeft, worden de eerste tien bronnen in de resultatenarray overgeslagen en worden de gegevens voor de volgende bronnen geleverd
- order_by
  Type: array string[] | null
  
  sorteerregels voor resultaten
  optioneel veld
  u kunt dezelfde waarden als in de array filters gebruiken om de resultaten te sorteren
  mogelijke sorteertypen:
  asc - resultaten worden in oplopende volgorde gesorteerd
  desc - resultaten worden in aflopende volgorde gesorteerd
  u moet een komma gebruiken om een sorteertype in te stellen
  voorbeeld:
  ["size,desc"]
  let op dat u per verzoek maximaal drie sorteerregels kunt instellen
  u moet meerdere sorteerregels met een komma scheiden
  voorbeeld:
  ["size,desc","fetch_timing.fetch_end,desc"]
- relevant_pages_filters
  Type: array string[] | null
  
  bronnen filteren op relevante pagina's
  optioneel veld
  met dit veld kunt u bronnen verkrijgen van pagina's die aan de gedefinieerde parameters voldoen
  u kunt hier dezelfde filters toepassen als beschikbaar voor het pagina-endpoint
  u kunt meerdere filters tegelijk toevoegen (maximaal 8 filters)
  u moet tussen de voorwaarden een logische operator and, or plaatsen
  de volgende operatoren worden ondersteund:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, like, not_like
  u kunt de operator % met like en not_like gebruiken om elke tekenreeks van nul of meer tekens te matchen
  voorbeeld:
  ["checks.no_image_title","=",true]
- search_after_token
  Type: string | null
  
  token voor vervolgverzoeken
  optioneel veld
  wordt bij elk verzoek in het gelijknamige veld van de respons geleverd;
  gebruik deze parameter om time-outs te voorkomen bij het ophalen van meer dan 20,000 resultaten in één verzoek;
  met de unieke waarde search_after_token uit de responsarray krijgt u de volgende resultaten van de oorspronkelijke taak;
  search_after_token-waarden zijn uniek per vervolgtaak;
  let op: als search_after_token in het verzoek wordt opgegeven, moeten alle andere parameters identiek zijn aan die van het vorige verzoek
- 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
- url
  Type: string | null
  
  pagina-URL
  optioneel veld
  geef dit veld op als u de bronnen voor een specifieke pagina wilt verkrijgen
  let op dat u de URL in dit veld moet opgeven om meta van een bron van een bepaalde URL te verkrijgen;
  als u bij het instellen van een taak geen url opgeeft, wordt meta van de bron in de resultaten geretourneerd op basis van de gegevens van de pagina waar onze crawler de bron voor het eerst heeft gezien

Responsen

200
Type: object | null · Response36Afe1097B20_OnPageResourcesResponseInfo
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_OnPageResourcesTaskInfo
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

crawl_progress
Type: string | null

status van de crawlsessie
mogelijke waarden: in_progress, finished

crawl_status
Type: object | null · Response36Afe1097B20_CrawlStatusInfo

details van de crawlsessie

max_crawl_pages
Type: integer | null Formaat: int64

maximaal aantal te crawlen pagina's geeft de max_crawl_pages-limiet aan die u hebt opgegeven bij het instellen van een taak

pages_crawled
Type: integer | null Formaat: int64

aantal gecrawlde pagina's

pages_in_queue
Type: integer | null Formaat: int64

aantal pagina's dat momenteel in de crawlwachtrij staat

current_offset
Type: integer | null

Integer numbers.

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

items-array

cache_control
Type: object | null · Response36Afe1097B20_CacheControl

instructies voor caching

cachable
Type: boolean | null

geeft aan of de pagina cachebaar is

ttl
Type: integer | null

time-to-live. de tijd dat de browser een resource in de cache bewaart

checks
Type: object | null

websitecontroles. on-page-controles met betrekking tot de pagina

propertyName
Type: boolean | null
content_encoding
Type: string | null

type codering

encoded_size
Type: integer | null

paginagrootte na codering. geeft de grootte aan van de gecodeerde pagina in bytes

fetch_time
Type: string | null

datum en tijd waarop een resource is opgehaald. in UTC-indeling: ‘yyyy-mm-dd hh-mm-ss +00:00’. voorbeeld: 2019-11-15 12:57:46 +00:00

last_modified
Type: object | null · Response36Afe1097B20_LastModified

bevat gegevens over wijzigingen aan de resource. als er geen gegevens zijn, is de waarde null

header
Type: string | null

datum en tijd waarop de header voor het laatst is gewijzigd in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”; voorbeeld: 2019-11-15 12:57:46 +00:00; als er geen gegevens zijn, is de waarde null

meta_tag
Type: string | null

datum en tijd waarop de meta-tag voor het laatst is gewijzigd in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”; voorbeeld: 2019-11-15 12:57:46 +00:00; als er geen gegevens zijn, is de waarde null

sitemap
Type: string | null

datum en tijd waarop de sitemap voor het laatst is gewijzigd in UTC-formaat: “yyyy-mm-dd hh-mm-ss +00:00”; voorbeeld: 2019-11-15 12:57:46 +00:00; als er geen gegevens zijn, is de waarde null

location
Type: string | null

location-header. geeft de URL aan waarnaar een pagina wordt omgeleid

media_type
Type: string | null

mediatypen die worden gebruikt om een pagina weer te geven

resource_errors
Type: object | null · Response36Afe1097B20_OnPageResourceIssueInfo

fouten en waarschuwingen van de resource

errors
Type: array (object | null)[] | null

resourcefouten

column
Type: integer | null

kolom waarin de fout is gevonden

line
Type: integer | null

regel waarin de fout is gevonden

message
Type: string | null

tekstbericht van de fout: de volledige lijst met mogelijke HTML-fouten vindt u hier

status_code
Type: integer | null

algemene statuscode. de volledige lijst met responscodes vindt u hier. Opmerking: we raden sterk aan een systeem te ontwerpen voor het afhandelen van de bijbehorende uitzonderings- en foutsituaties

warnings
Type: array (object | null)[] | null

resourcewaarschuwingen

column
Type: integer | null

kolom waarin de fout is gevonden

line
Type: integer | null

regel waarin de fout is gevonden

message
Type: string | null

tekstbericht van de fout: de volledige lijst met mogelijke HTML-fouten vindt u hier

status_code
Type: integer | null

algemene statuscode. de volledige lijst met responscodes vindt u hier. Opmerking: we raden sterk aan een systeem te ontwerpen voor het afhandelen van de bijbehorende uitzonderings- en foutsituaties

resource_type
Type: string | null

elementtype

server
Type: string | null

serverversie

size
Type: integer | null

grootte van de resource. geeft de grootte aan van een pagina in bytes

status_code
Type: integer | null

algemene statuscode. de volledige lijst met responscodes vindt u hier. Opmerking: we raden sterk aan een systeem te ontwerpen voor het afhandelen van de bijbehorende uitzonderings- en foutsituaties

total_transfer_size
Type: integer | null Formaat: int64

gecomprimeerde paginagrootte. geeft de gecomprimeerde grootte aan van een pagina

url
Type: string | null

pagina-URL

items_count
Type: integer | null Formaat: int64

aantal items in de resultatenarray

search_after_token
Type: string | null
total_items_count
Type: integer | null Formaat: int64

totaal aantal gecrawlde relevante items

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/on_page/resources

curl https://openapi.felo.ai/v1/beta/dataforseo/on_page/resources \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "id": "07281559-0695-0216-0000-c269be8b7592",
    "filters": [
      [
        "resource_type",
        "=",
        "image"
      ],
      "and",
      [
        "size",
        ">",
        100000
      ]
    ],
    "order_by": [
      "size,desc"
    ],
    "limit": 10
  }
]'

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": [
        {
          "crawl_progress": null,
          "crawl_status": {
            "max_crawl_pages": null,
            "pages_in_queue": null,
            "pages_crawled": null
          },
          "search_after_token": null,
          "current_offset": null,
          "total_items_count": null,
          "items_count": null,
          "items": [
            {
              "resource_type": null,
              "status_code": null,
              "location": null,
              "url": null,
              "resource_errors": "[Max Depth Exceeded]",
              "size": null,
              "encoded_size": null,
              "total_transfer_size": null,
              "fetch_time": null,
              "cache_control": "[Max Depth Exceeded]",
              "checks": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "last_modified": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Geslaagde bewerking

OnPage API: bronnen

AuthenticatieRequired

DataForSEO

OnPage API: bronnen

Prijsreferentie