# Read.write.as API

**URL:** <https://discuss.write.as/t/read-write-as-api/492>\
**Category:** Platform\
**Created:** [March 26, 2019, 9:23pm UTC](https://discuss.write.as/t/read-write-as-api/492 "2019-03-26T21:23:13Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![cjeller1592](https://discuss.write.as/user_avatar/discuss.write.as/cjeller1592/32/128_2.png) [@cjeller1592](https://discuss.write.as/u/cjeller1592)\
**Post date:** [March 26, 2019, 9:23pm UTC](https://discuss.write.as/t/read-write-as-api/492/1 "2019-03-26T21:23:13Z")

</div>

Can [read.write.as](https://read.write.as) be accessed from the Write.as API? Perhaps as a special collection? I can imagine some interesting possibilities with such an API open to people. Thanks!

---

<div class="post-metadata">

**Author:** ![matt](https://discuss.write.as/user_avatar/discuss.write.as/matt/32/2760_2.png) [@matt](https://discuss.write.as/u/matt)\
**Post date:** [March 27, 2019, 6:32pm UTC](https://discuss.write.as/t/read-write-as-api/492/2 "2019-03-27T18:32:20Z")

</div>

Yep, we have a minimal, experimental API in place right now. It’s basically just one endpoint:

> `GET https://read.write.as/api/posts`
> 
> Returns 100 most-recent Read Write.as posts, paginated.
> 
> _Optional parameters:_
> 
> | parameter | example value | use |
> | --- | --- | --- |
> | `skip` | 10 | Specifies the number of posts to skip, for implementing pagination. |

Data is returned in the same JSON structure as the Write.as API, including the data envelope, so it should be possible to reuse data structures from those client libraries.

Our goal in having this was to eventually create a Read Write.as mobile app, but with [Read.as](https://read.as) now we’ll likely end up building something larger / more generalized, so we don’t have any active plans to develop the API further. But if you want to share what you’d like to build, maybe we could support certain features you need.

---

<div class="post-metadata">

**Author:** ![cjeller1592](https://discuss.write.as/user_avatar/discuss.write.as/cjeller1592/32/128_2.png) [@cjeller1592](https://discuss.write.as/u/cjeller1592)\
**Post date:** [March 27, 2019, 9:26pm UTC](https://discuss.write.as/t/read-write-as-api/492/3 "2019-03-27T21:26:40Z")

</div>

Thanks Matt,

I just included this endpoint in an update to the Write.as [Python library](https://github.com/cjeller1592/Writeas-API/blob/master/README.md).

My first inclination is to use this API to search for certain tags, but that is something I can do so within this current API. Will play around with it more to get a sense of what additional features would be needed.

---

<div class="post-metadata">

**Author:** ![cjeller1592](https://discuss.write.as/user_avatar/discuss.write.as/cjeller1592/32/128_2.png) [@cjeller1592](https://discuss.write.as/u/cjeller1592)\
**Post date:** [May 2, 2019, 4:44pm UTC](https://discuss.write.as/t/read-write-as-api/492/4 "2019-05-02T16:44:01Z")

</div>

Just noticed that the returned Read Write.as posts have zero views, regardless of what a post’s view count actually is. Totally understand if this is unsalvageable. I thought of creating a little utility that would grab the most viewed posts from the Read Write.as feed.