What is PVAPi? In a nutshell, PVAPi represents Pink Visual "handing you the keys to our car," so to speak. PVAPi puts our data and our content in your hands, enabling you to create promotional tools based on your own vision, and your own programming skills."

Our Data, Your Application

Over the years, Pink Visual® has received a lot of feedback from people saying
something like "You guys have all this great metadata; why don't you do {X} with it?" PV™ APi is your chance
to put your own idea where that {X} is! Use our data for SEO, use it to create a pornstar index. the sky's the limit!

Our Content, Your Display

Think you have a better idea for how
to display and use Pink Visual® content than the ways we've done it ourselves?
Show us, and the rest of the world, what you've got - and earn money at the same
time! This isn't some mere 'whitelabel' system; this is us giving you all the tools
to create adult entertainment greatness!

Hardcore episode thumbnails

All of our episodes already provide a thumbnail (usually a headshot) in the 160x120 size. Now, we're also sending a second thumbnail, also 160x120, that shows a little more of the action.

Check out the new "hardcore_thumb" key in any set of episode data! View Less

Nov 17, 2011

API Key Access: Updates

Have you noticed that your API key(s) have a "Level" in your Settings page? What is that?
...
View Full Article

Have you noticed that your API key(s) have a "Level" in your Settings page? What is that?

When you generate a new API key (or, get one automatically when you sign up), it has the "Development" level. There's also the "Approved" level, and a new level we've just added.

Approved: This key has full access to data. There's no cap on the "start" parameter, and "limit" is only limited on certain requests (some API requests do force you to paginate).

Development: Keys with the Development level can get at most two pages, with 10 items per page. The "start" value is limited to 10 and so is the "limit". You're free to use this key while you develop, but you should upgrade it to "Approved" if you want to use the whole library.

Demo: This is our new key level. Demo keys are for tools you create and plan to distribute (e.g. a blog plug-in that wraps the PV API). We don't want you distributing an Approved key because people using your software will be using your key and have no incentive to get their own. We recommend you give your users a way to enter their own key, and link them to our website. Demo keys have "start" and "limit" both capped at 1, meaning you can fetch two pages with one item each.

"But how do I get my key Approved?"
Head to our Support Page and choose "Project Approval Request". Tell us how to see what you've down with the API (a url is best, but if your implementation isn't a website, we can work with you to figure out how we'll review it) and we can probably get you approved pretty quickly.

"And why should I bother if my site works well with a Development key?"
We can't promise the restrictions on the dev keys will stay the same. Maybe you're fine with the 10-items-per-page limit. Maybe your site looks great! But if we change these limits later, you might find your site doesn't do what you want.

API Fixes

It's good to see so many of you trying out our new API. We've gotten some good feedback. Here is a list of things we've fixed:
...
View Full Article

It's good to see so many of you trying out our new API. We've gotten some good feedback. Here is a list of things we've fixed:

The single-source request was returning its source in the "niches" key, which was an error. It now comes in the "sources" key.

CURL was on our user agent blacklist. This was an oversight because it was preventing CURL from being used to fetch our data.

Errors should no longer trigger 307 redirects. You should get a 404, plus the body of the page (in json or xml, as requested) stating the "errorcode" number and "error" message. If you still manage to get a 307 redirect, please let us know via the support form.

Have you had any other issues with the API? You can let us know with the "Support" button. We're interested in your feedback. View Less

Oct 14, 2011

Development API Keys

You might have noticed that your API key says "Development". What does that mean? Well, it means we have to see your website/app and approve it before you have full access to our content.
...
View Full Article

You might have noticed that your API key says "Development". What does that mean? Well, it means we have to see your website/app and approve it before you have full access to our content.

While your key is labeled "Development", you have two main limitations:

The "limit" value you pass to any API request cannot be higher than 10. If you pass a higher limit, or request no limit, it'll go to 10.

The "start" value can't be higher than 9. As with limit, we'll drop it to 9 if you ask for something higher.

Why start=9 and limit=10? Well, it lets you do the first 2 "pages" of any request at 10 items per page.

You can write your code with whatever start and limit you want, so that once we approve your API key, everything will start working normally.

Once you're ready to submit for approval, head on over to our Support page and send us the details. View Less

1The Big Picture:

Through PV™ APi, Pink Visual® is making our data and content
available to you, the developer. Aside from some very basic and
Sensible rules (please see our Terms of Service) you are free to
do with these resources as you like, from crafting mobile apps to
creating a video interface that loads clips from our content
database at random, or even authoring a game based on Pink
Visual®'s data and content.