Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Cache Location API
description: 'RESTful API for Instagram and TikTok data. Access user profiles, posts, stories, highlights, comments, hashtags, locations, audio tracks (Instagram), and videos, comments, hashtags, playlists (TikTok).
All endpoints require an `access_key` query parameter for authentication (handled by the gateway).
**Rate limits** depend on your plan. Instagram responses are served from cache with automatic fallback to HikerAPI when available; TikTok responses are cache-only.'
termsOfService: https://datalikers.com/help/terms-of-service
license:
name: Pricing
url: https://datalikers.com/pricing
version: 2.10.1
tags:
- name: Location
description: Instagram locations — lookup by PK or name search.
paths:
/v1/location/by/id:
get:
tags:
- Location
summary: Get location by ID
description: 'Retrieve an Instagram location by its numeric PK.
Returns the location object including name, address, city,
latitude/longitude coordinates, and associated media count.'
operationId: location_by_id_v1_location_by_id_get
security:
- APIKeyQuery: []
parameters:
- name: id
in: query
required: true
schema:
type: integer
description: Instagram location PK (numeric ID)
title: Id
description: Instagram location PK (numeric ID)
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Location By Id V1 Location By Id Get
'404':
description: Location not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v1/location/by/name:
get:
tags:
- Location
summary: Search location by name
description: 'Find an Instagram location by name (case-insensitive search).
Returns the first matching location object. Use this when you
don''t know the numeric PK but have the location name.'
operationId: location_by_name_v1_location_by_name_get
security:
- APIKeyQuery: []
parameters:
- name: name
in: query
required: true
schema:
type: string
description: Location name to search for
title: Name
description: Location name to search for
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Location By Name V1 Location By Name Get
'404':
description: Location not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
securitySchemes:
APIKeyQuery:
type: apiKey
in: query
name: access_key
externalDocs:
description: Get the access_key
url: https://datalikers.com/tokens