Twingly

Help

Documenting the features of Twingly

Search language documentation  —  A description of Twingly's almighty search language

Widget documentation  —  A description of the Twingly widgets

Power searching
To contents

Searching for blog posts linking to one or more sites.

You can search for blog posts that link to any page on twingly.com.

Example: link:twingly.com

You can also search for posts that link to several sites. This search will return blog posts that link to both twingly.com and techcrunch.com (or any page under those domains).

Example: link:twingly.com,techcrunch.com

You can also use | instead of , to get blog posts that links to either twingly.com or techcrunch.com (or any page under those domains).

Example: link:twingly.com|techcrunch.com

Searching for blog posts from blogs on a specific domain.

You can search for blog posts from blogs on a specific domain. This also matches subdomains. This search matches blog.twingly.com, even if though not directly on twingly.com

Example: site:twingly.com

You can search for blog posts from blogs on one or several domains.

Example: site:twingly.com|primelabs.se

Searching for blog posts from a specific blog.

You can search for blog posts from a specific blog. This only matches against exact urls to blogs, so searching for "blog:twingly.com" does not return any results.

Example: blog:blog.twingly.com

You can also search for blog posts from one of several blogs.

Example: blog:blog.twingly.com|roslingsblogger.blogspot.com

Searching for blog posts written in a specific language.

You can search for blog posts written in a specific language. This will search for blog posts written in Swedish.

Example: lang:sv

You can also specify several languages for your search.

Example: lang:sv|fi

Searching for blog posts tagged with a specific tag.

You can search for blog posts tagged with "election".

Example: tag:election

You can also search for posts with multiple tags.

Example: tag:election,obama

Or you can search for posts tagged with one or many tags.

Example: tag:election|sport|fashion

Searching in the spam-free index

The default is to search in the entire index, with both approved and non-approved blogs.

You can limit the search to only search in the spam-free index.

Example: approved:1

Of course, you can also search among the non-approved blog posts.

Example: approved:0

To search in both approved and non-approved blogs, don't use the approved operator at all.

Searching for blog posts posted within a certain time span

The default is to search in to search for posts posted in any time.

You can search for posts that were posted within the last 24 hours.

Example: tspan:24h

The supported options to tspan are:

  • The last hours: h
  • The last 12 hours: 12h
  • The last 24 hours: 24h
  • The last week: w
  • The last month: m

Widget

To contents

Our widget platform gives bloggers the ability to display relevant content from our search on their blogs. You can now easily let your readers see who has linked to your blog or what posts that has the highest TwinglyRank. Any search result is available in an easy to use widget.

Getting the widget

The installation process is aimed to be simple and fast. The easiest way is to start by finding a widget you would like to put on your blog and click "Get this widget for your blog" at the bottom. You can also find the same link at the bottom of any search result. For inspiration, have a look at the blog profile page for any blog, like the profile for our blog.

When clicking the "Get this widget" link, a popup window will appear. It contains the HTML you need to include in your page template. Next, do the following steps:

  • Copy the content of the first text area and put it where ever you want the widget to appeare on your blog.
  • Change the value in the <span class="query">blog:http://change_this_to_yourblogurl</span> to the url for your blog.
  • Copy the content of the second text area (the script tag) and put it just before the closing </body> tag.

When you are done, your page template should look something like this: 

<html>
    <head>
    </head>
    
    <body>
        <!-- some html -->
        
        <div class="twingly_widget">
            <a href="http://www.twingly.com">Twingly Blog Search</a>
            <span class="query">link:http://blog.twingly.com/ sort:published</span>
            <span class="title">Most recent posts linking to Twingly Blog: Zen of Spam-Free</span>
        </div>

        <!-- some more html -->

        <script type="text/javascript" src="http://static.twingly.com/jsapi/1.0/twingly.js"></script>
    </body>
</html>

And now your done! Sit back and marvel at the beauty appearing on your blog.

Examples

We have created 3 example widgets (queries), just replace http://blog.twingly.com with the address to your blog.

  • The most recent posts linking to a blog: 
    <div class="twingly_widget">
    <a href="http://www.twingly.com">Twingly Blog Search</a>
    <span class="query">link:http://blog.twingly.com/ sort:published</span>
</div>

  • The most linked posts: 
    <div class="twingly_widget">
    <a href="http://www.twingly.com">Twingly Blog Search</a>
    <span class="query">blog:http://blog.twingly.com/ sort:inlinks</span>
    <span class="template">ShowBlog=no</span>
</div>

  • The latest published posts: 
    <div class="twingly_widget">
    <a href="http://www.twingly.com">Twingly Blog Search</a>
    <span class="query">blog:http://blog.twingly.com/ sort:published</span>
    <span class="template">ShowBlog=no</span>
</div>

Including widgets on your page

Remember! You also need to include this at the bottom of the page, or page template, for the widget to work. Place it just before the closing </body> tag. 

<script type="text/javascript" src="http://static.twingly.com/jsapi/1.0/twingly.js"></script>

To use any of these, all you have to do is change the address (URL) to your blogs address as mentioned above.

Customize it!

The Twingly widgets are build so that it should be easy to customize both its content and the way it looks. As long as you agree to the Terms of use you are free to do pretty much anything. In fact, we would love to see you do something cool with it.

To customize the widget, you can use the following configuration fields:

  • query — use to specify the query:

    Example: <span class="query">link:blog.twingly.com* sort:published</span>


  • title — use to specify the title that is shown in the widget:

    Example: <span class="title">Recent blog posts linking to my blog</span>


  • count — use to limit the number of posts shown (maximum is 10, default is 5):

    Example: <span class="count">3</span>

    The number of results returned from a search is always at most 10. The actual number of results depends on what the search returned, count is used to limit the maximum number of posts shown. Use count if you want to show for example only 3 items.


  • template — use to specify a pre-defined template option:

    Example: <span class="template">ShowBlog=no</span>

    Options:

    • ShowBlog=no: For use when showing information about a blog. Hides the RSS icon and the link to the blog.

The core functionality of the widgets is to display search results. What will be displayed is therefore decided by the search query.