The Outside.in API lets you easily integrate hyperlocal news in your sites and applications by providing recent news stories and blog posts for any neighborhood, ZIP code, city, or state in the United States.  

Get Started

1. Get a key . 
2. Browse the  documentation .
3. Follow @outsideinAPI  on Twitter.

How it Works

Search for Stories

Send the name of any U.S. neighborhood, ZIP code, city, or state to our  Stories Query Resource  to get information about the region (including geographic centerpoint and containing region), plus the most recent stories we’ve associated with that region.

You can filter the stories returned by:

• keyword:  search within the titles, summaries, and topic tags associated with each story
• timestamp:  limit your results to stories of a specified age
• feed category:  our  three-part source taxonomy  allows you to specify the feeds you’d like to receive stories from by any or all of the following:
  • vertical:  this includes topics like news, crime, and politics
  • format:  this distinguishes by feeds that publish blog posts, traditional news articles, reviews, etc.
  • author type:  this allows you to select stories published by mainstream media outlets, unaffiliated individual bloggers, sharing sites with multiple authors, etc.

Our story results come from more than 54,000 RSS feeds published by bloggers, mainstream media outlets, and independent new media sites across the country. 

Want More Control?

You can use our Hyperlocal Dashboard  to curate the feeds and stories that show up in the results of your API calls. Create an account at publishers.outside.in , then contact us at support {at} outside {dot} in for an API key that's authorized to retrieve information from your account.

Search for Locations

If you’re building an application that requires user input to identify a location, you can use our  Locations Query Resource  to find locations matching any string. The location metadata returned includes a unique identifier that can be used to lookup stories for any matching location.

Rate Limits

The API is free to use for up to 5,000 queries per day or 2 queries per second. For a commercial agreement, please contact publishers {at} outside {dot} in .

Outside.in for Publishers Curation

If your company uses Outside.in for Publishers to curate stories and feeds, you can amend all requests to our API to only return stories and feeds that you have selected in your Publisher Dashboard. To get an API key that is authorized to retrieve information from your account, email support {at} outside {dot} in .