Keyword Discovery - GRATIS API handleiding
Klik hier om toegang te krijgen tot de handleiding voor de Volledige functie API optie als onderdeel van de Enterprise abonnement.
Het Keyword Research API (Application Programming Interface) biedt een aantal zoekopdracht functies naar de Keyword Research databestand. De API kan worden geïntegreerd in persoonlijke toepassingen of gebruikt als een alternatieve interface.
De API biedt functies voor het onttrekken van data op enkele trefwoorden, meerdere trefwoorden van een enkele zoekopdracht en account status controle. De zoekopdrachten retourneren alle data in XML formaat en de functies accepteren parameters zoals GET of POST waarden.
Als u bestaande Keyword Discovery login details hebt neem contact met ons op om uw gratis API functies te activeren, of voor nieuwe gebruikers creër een nieuw login account en dan verzoek API toegang om te activeren.
OPMERKING: De optie tussen enkele en meerdere zoekopdrachten dienen te worden geactiveerd door admin, gebruik is niet in staat om het type zoekresultaten te wijzigen door de URL parameters te modificeren. Neem contact met ons op om de resultaten type voor uw account te wijzigen.
Voor meer informatie over hoe u de KeyowrdDiscovery API kunt implementeren in uw toepassingen gebruikmakend van programma talen, bekijk actual PHP, Perl en C#.Net code voorbeelden.
Inhoud
Gebruik van Gratis API Vereisten
Alle toepassingen van de gratis API dienen correct een link te tonen naar http://www.Keyword Discovery.nl/
Suggereerde formaten:
Optie 1.
Keywords aangeleverd door Keyword Discovery.com
Voor meer resultaten bezoek Keyword Discovery.com Keyword Research Tool
Optie 2.
Trefwoord resultaten door Keyword Discovery.com Keyword Research Tool
Enkele Zoekopdracht
Deze functie werkt op dezelfde manier als de zoek functie op de Keyword Research website. Een zoekopdracht string bevat een zoekterm wat is gestuurd naar de databestand welke een lijst retourneert van zoekterm combinaties welke de originele zoekterm bevat, tezamen met het totaal van zoekopdrachten, en het aantal maandelijkse zoekopdrachten. De zoekopdracht kan persoonlijk worden gemaakt om subsets te retourneren van data via de parameters hieronder aangegeven.
Parameters:
Zoekopdracht string/zoekterm (vereist)
Parameter naam: zoekopdracht
Aliassen: q, zoeken, zoekopdrachten
Beschrijving: De zoekterm om de zoekopdracht op uit te voeren.
Beperking
Parameter naam: beperking
Aliassen: l, m, limited_to, maximum
Standaard: 10
Maximum: Account specifiek (standaard 10)
Beschrijving: Het maximum aantal resultaten geretourneerd.
Compact resultaten
Parameter naam: compact
Aliassen: c
Standaard: 1 (aan)
Waarden: 1,0 (aan,uit)
Beschrijving: Retourneert resultaten met afgekorte veldnaam beschrijvingen. B.v. totaal="1622" zal worden vertoond als t="1622".
Resultaten
Resultaten worden geretourneerd als XML. Een simpel voorbeeld:
http://api.Keyword Discovery.com/top15.php?query=airport+parking
Dit verzoek is voor de zoek search term "airport parking", de zoekopdracht zal data startend van de 10de resultaat tonen, en een maximum van 15 resultaten zal worden geretourneerd. Per standaard, compact resultaten vertonen is aangezet. De XML retourneert van deze zoekopdracht wat hieronder is aangegeven:
<resultset>
<results compact="true" maximum="10" offset="0" query="airport parking" sub10="false">
<r m="3619" q="airport parking" t="57907"/>
<r m="762" q="airport parking uk" t="9912"/>
<r m="1194" q="newcastle airport car parking" t="9558"/>
<r m="858" q="luton airport car parking" t="9446"/>
<r m="279" q="gatwick airport parking" t="4188"/>
<r m="251" q="newark airport parking" t="3272"/>
<r m="228" q="stansted airport parking" t="3192"/>
<r m="211" q="philadelphia airport parking" t="2963"/>
<r m="222" q="jfk airport parking" t="2889"/>
<r m="178" q="oakland airport parking" t="2495"/>
</results>
</resultset>
Elk resultaat is geretourneerd als een 'r' tag met de volgende attributen
- q - query string
- t - totale zoekopdracht
- m - maandelijkse schatting
De enkele zoekopdracht functie is beschikbaar op de URL http://api.Keyword Discovery.com/top15.php
Meerdere Zoekopdrachten
De zoekopdrachten functie kan meerdere zoektermen in één keer accepteren, beperkt tot een maximum van 100, en retourneert het totaal aantal van zoekopdrachten en het aantal maandelijkse zoekopdrachten voor elke zoekterm.
Parameters:
De hoofd parameter is de lijst van zoekopdrachten strings, één zin per regel.
Zoekopdracht string (vereist)
Parameter naam: zoekopdracht
Aliassen: q, zoek, zoekopdrachten, zoeken
Beschrijving: Zoektermen gescheiden door newline karakters
Beperking: Het aantal zoekopdrachten welke u kunt geven op één bepaald moment is beperkt op een per account basis
Compact resultaten
Parameter naam: compact
Aliassen: c
Standaard: 1 (aan)
Waarden: 1,0 (aan,uit)
Beschrijving: Retourneert resultaten met afgekorte veldnaam beschrijvingen. B.v. totaal="1622" zal worden getoond als t="1622"
Resultaten
Resultaten worden geretourneerd als XML. Een simpel voorbeeld:
http://api.Keyword Discovery.com/top15.php?queries=airport+parking%0D%0Afree+web+hosting
Dit verzoek is voor de zoektermen "airport parking" en "free web hosting". Per standaard, compact resultaten tonen is aangezet. De XML geretourneerd van deze zoekopdracht is hieronder te zien:
<resultset>
<results compact="true" maximum="15" offset="0" query="airport parking" sub10="false">
<r m="3619" q="airport parking" t="57907"/>
<r m="762" q="airport parking uk" t="9912"/>
<r m="1194" q="newcastle airport car parking" t="9558"/>
<r m="858" q="luton airport car parking" t="9446"/>
<r m="279" q="gatwick airport parking" t="4188"/>
<r m="251" q="newark airport parking" t="3272"/>
<r m="228" q="stansted airport parking" t="3192"/>
<r m="211" q="philadelphia airport parking" t="2963"/>
<r m="222" q="jfk airport parking" t="2889"/>
<r m="178" q="oakland airport parking" t="2495"/>
<r m="159" q="dfw airport parking" t="2072"/>
<r m="147" q="airport car parking" t="2064"/>
<r m="1028" q="airport parking, gatwick" t="2057"/>
<r m="150" q="manchester airport parking" t="1961"/>
<r m="142" q="airport parking gatwick" t="1710"/>
</results>
<results compact="true" maximum="15" offset="0" query=" free web hosting" sub10="false">
<r m="75067" q="free web hosting" t="1201077"/>
<r m="15790" q="free web page hosting" t="252643"/>
<r m="1492" q="free website hosting" t="23886"/>
<r m="933" q="web hosting free" t="12141"/>
<r m="237" q="list free web hosting" t="3090"/>
<r m="192" q="free web hosting php" t="3087"/>
<r m="241" q="free and web and hosting" t="2652"/>
<r m="180" q="free web hosting no ads" t="2527"/>
<r m="160" q="free adult web hosting" t="2400"/>
<r m="164" q="free web hosting service" t="2297"/>
<r m="378" q="free web hosting home business" t="2273"/>
<r m="201" q="free adult web cam hosting" t="2010"/>
<r m="105" q="free web hosting frontpage" t="1692"/>
<r m="118" q="free web hosting no adds" t="1535"/>
<r m="105" q="free web hosting ftp" t="1481"/>
</results>
</resultset>
Elk resultaat wordt geretourneerd als een 'r' tag met de volgende attributen
- q - query string
- t - totaal zoekopdracht
- m - maandelijkse schatting
Deze functie is beschikbaar op http://api.Keyword Discovery.com/top15.php
Autenticatie
Autenticatie voor het API systeem wordt uitgevoerd met gebruik van de standaard HTTP autenticatie. Wanneer een zoekopdracht wordt verstuurd via de API met gebruik van een webbrowser een bericht box zal verschijnen, eist de account houders gebruikersnaam en paswoord om te worden ingevuld om door te gaan.
Autenticatie details kunnen ook via de URL worden verstuurd door de gebruikersnaam en paswoord gescheiden ingevoegd door een colon en suffixed met @, voor de hostnaam in de zoekopdracht URL.
OPMERKING: Onthoud dat data aangeboden via URL's dienen correct te worden geencodeerd.
OPMERKING: Microsoft Internet Explorer heeft de mogelijkheid om gebruikersnamen en paswoorden aan te bieden uitgezet via de URL in de laatste versies.
Dit zal u stoppen van het testen in deze Internet Explorer.
Een voorbeeld van het controleren van de account status laat de URL autenticatie methode zien:
gebruikersnaam: user@host.com
paswoord: geheim
http://user%40host%2Ecom:secret@api.Keyword Discovery.com/top15.php
Een autenticatie mislukking zal een HTTP 401: Ongeautoriseerd retourneren.
|
